Menggunakan Protokol pencarian

Pencarian : protokol aplikasi adalah konvensi yang dapat diperluas untuk memanggil aplikasi pencarian desktop di Windows Vista dengan Paket Layanan 1 (SP1) dan versi yang lebih baru. Protokol dibuat di Windows Vista dengan SP1 untuk memberi Windows cara untuk menentukan dan memanggil aplikasi pencarian desktop default.

Sintaks protokol menyediakan sejumlah parameter yang berguna untuk melakukan pencarian desktop umum, seperti istilah pencarian yang dimasukkan pengguna atau lokasi tempat pencarian dimulai. Ketika pengguna mencari dari salah satu dari dua titik entri pencarian yang tersedia (baik menu Mulai atau Windows Explorer), sistem operasi menggunakan protokol pencarian untuk meluncurkan aplikasi pencarian desktop default. Ini dilakukan dengan menambahkan istilah pencarian yang dimasukkan pengguna ke sintaks protokol pencarian standar dan meneruskan informasi tersebut ke aplikasi yang terdaftar sebagai aplikasi pencarian default.

Jika tidak ada aplikasi pencarian desktop lain yang diinstal, pencarian yang dimasukkan ke titik masuk ini meluncurkan Windows Search Explorer. Namun, pengembang pihak ketiga dapat membuat, menginstal, dan mendaftarkan aplikasi mereka untuk menangani protokol pencarian dan menjadi aplikasi pencarian default. Aplikasi tersebut perlu mendukung sintaks protokol pencarian dan mendaftar dengan fitur Program Default untuk memastikan pengalaman yang mulus dengan Windows.

Jika Anda mengembangkan aplikasi yang dimaksudkan untuk menggunakan atau membangun aplikasi pencarian desktop tertentu, Anda tidak boleh bergantung secara eksklusif pada protokol pencarian: . Karena banyak aplikasi yang dapat memiliki pencarian: protokol, tidak ada jaminan bahwa aplikasi pencarian desktop yang Ditargetkan akan memilikinya pada waktu tertentu. Sebagai gantinya, Anda harus menggunakan protokol pencarian privat yang ditentukan oleh aplikasi pencarian desktop yang ditargetkan. Ini berarti bahwa aplikasi pencarian desktop yang dimaksudkan untuk menjadi platform untuk aplikasi pihak ketiga harus mendukung pencarian: protokol dan protokol pencarian milik mereka sendiri.

Topik ini mencakup hal-hal berikut:

• Sintaksis
• Windows Vista dengan penggunaan SP1 pencarian: protokol
• Contoh
• Mendaftarkan Aplikasi yang Menangani Protokol
  • Entri Registri
• Topik terkait

Sintaks

Protokol pencarian menggunakan sintaksis berkode URL standar berikut:

search:parameter=value[&parameter=value]&

Sintaks dimulai dengan mengidentifikasi protokol itu sendiri (pencarian:). Pasangan parameter/nilai adalah argumen yang diteruskan ke mesin Pencarian, seperti yang dijelaskan dalam tabel berikut, yang menunjukkan semua parameter yang mungkin untuk sintaks protokol pencarian.

Windows Vista dengan penggunaan SP1 pencarian: protokol

Windows Vista dengan SP1 memiliki beberapa titik masuk dari mana ia memanggil protokol pencarian: . Titik masuk ini diuraikan di bawah ini serta sintaks umum yang terkait dengan masing-masing.

Titik entri protokol pencarian Windows Vista dengan SP1 tidak memanfaatkan semua parameter yang mungkin dalam protokol pencarian. Aplikasi yang hanya berkaitan dengan penanganan panggilan protokol pencarian dari Windows Vista dengan SP1 dapat menggunakan tabel berikut sebagai panduan minimal yang perlu mereka terapkan.

Contoh

Jika pengguna memasukkan "Microsoft" di menu Mulai dan mengklik Cari di Mana Saja, panggilan protokol pencarian yang dihasilkan dilakukan:

search:query=microsoft&

Jika pengguna memasukkan "Seattle" di Windows Explorer dalam C:\MyFolder lalu mengklik Cari Di Mana Saja, panggilan berikut dilakukan, menggunakan karakter escape untuk ':' dan '\':

search:query=seattle&crumb=location:C%3A%5CMyFolder

Mendaftarkan Aplikasi yang Menangani Protokol

Karena beberapa aplikasi dapat bersaing untuk protokol pencarian, Anda harus mendaftarkan aplikasi Anda dengan fitur Program Default selama penginstalan untuk memungkinkan pengguna mengonfigurasi default dengan lebih mudah. Selain prosedur penginstalan yang biasanya dipraktikkan di bawah Windows XP, aplikasi berbasis Windows Vista harus mendaftar dengan fitur Program Default sehingga aplikasi dan pengguna dapat mengonfigurasi default dengan mulus.

Setelah menginstal file biner yang diperlukan di komputer pengguna, rutinitas penginstalan Anda harus menyelesaikan tugas umum ini:

1. Tulis ProgID ke HKEY_LOCAL_MACHINE, seperti yang dijelaskan di bawah ini. Perhatikan bahwa aplikasi harus membuat ProgID khusus aplikasi untuk protokol pencarian.
2. Klaim asosiasi protokol pencarian tingkat mesin.
3. Daftarkan aplikasi dengan Program Default, seperti yang dijelaskan dalam Mendaftarkan Aplikasi untuk Digunakan dengan Program Default, sebagai pesaing untuk protokol pencarian.

Entri Registri

Berikut ini adalah contoh entri registri yang diperlukan untuk aplikasi pencarian desktop fiksi, Contoso Search.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            URL Protocol = ""

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            DefaultIcon
               (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe,-7

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            shell
               open
                  command
                     (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe %1

HKEY_LOCAL_MACHINE
   SOFTWARE
      RegisteredApplications
         Contoso Search = "Software\\Contoso\\Search\\Capabilities"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               ApplicationName = "Contoso Search Test App"
               ApplicationDescription = "Contoso search is a great new desktop search application"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               UrlAssociations
                  search = "contoso-search"

Topik terkait

Sintaks Kueri Tingkat Lanjut

Program Default