Menggunakan Protokol pencarian
Pencarian:
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.
Catatan
Protokol search: tidak menggantikan protokol search-ms: yang bersifat kepemilikan. Aplikasi masih dapat menggunakan protokol search-ms: untuk meluncurkan Window Search Explorer atau untuk mengkueri pengindeks Windows Search secara diam-diam.
Topik ini mencakup hal-hal berikut:
- Sintaksis
- Windows Vista dengan SP1 menggunakan protokol pencarian:
- Contoh
- Mendaftarkan Aplikasi yang Menangani Protokol
- Topik terkait
Protokol pencarian menggunakan sintaksis berkode URL standar berikut:
search:parameter=value[¶meter=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.
| Parameter | Nilai | Deskripsi |
|---|---|---|
| pertanyaan | Teks yang dikodekan URL | Teks kueri yang dimasukkan oleh pengguna. |
| inputlocale | ID kode bahasa yang valid (LCID) | LCID yang mengidentifikasi bahasa input untuk pencarian. |
| kata kunci lokal | LCID yang valid | LCID yang mengidentifikasi bahasa pengindeks versi internasional. Defaultnya adalah 1033 (en-us). |
| Remah | Pernyataan AQS | Argumen ini membatasi cakupan yang sedang dicari. Di Windows Vista, protokol pencarian mendukung AQS penuh serta implementasi khusus untuk location argumen. Di Windows XP, protokol pencarian juga mendukung AQS penuh, kecuali untuk implementasi kind khusus dan store. |
| sintaksis | NQS, AQS (tidak memperhatikan huruf besar/kecil) | Sintaks kueri yang digunakan untuk mencari indeks: Sintaks Kueri Alami atau Sintaks Kueri Tingkat Lanjut (AQS). AQS adalah default dan selalu dianggap diurai dan didukung. |
| stackedby | Properti apa pun yang valid dari sistem properti | Properti yang menentukan kolom tempat hasil akan ditumpuk. |
| subkueri | Jalur yang sepenuhnya ditentukan untuk file Pencarian Tersimpan (*.search-ms) | Hasil subkueri digunakan sebagai sumber untuk kueri. Artinya, istilah kueri dicocokkan dengan hasil subkueri. |
| nama tampilan | String yang dikodekan URL | Nama pencarian yang sedang berlangsung. |
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 masuk protokol pencarian | Lokasi | Kueri yang dipanggil |
|---|---|---|
| Pencarian di Mana Saja | Menu mulai | search:query=<Istilah Pencarian> |
| Cari di Mana Saja | Windows Explorer | search:query=<Istilah Pencarian>&crumb=location:<LOKASI> |
| Kunci logo Windows+F | Di mana saja | Cari: |
| CTRL+F | Windows Explorer | search:query=<Search Term>&crumb=location:<LOCATION> |
| F3 | Menu mulai | pencarian: |
| F3 | Windows Explorer | search:query=<Search Term>&crumb=location:<LOCATION> |
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.
| Parameter | Digunakan oleh Windows? | Bagaimana Windows Vista dengan SP1 menggunakannya saat memanggil pencarian: |
|---|---|---|
| kueri | Ya | Teks kueri yang dimasukkan oleh pengguna. |
| Remah | Ya |
crumb menggunakan location argumen untuk menentukan dari mana kueri berasal. |
| subkueri | Ya | Hasil argumen Subkueri digunakan sebagai cakupan item untuk dicari. Ini biasanya akan digunakan jika pengguna menggunakan file .search-ms untuk mencari dan kemudian memanggil aplikasi pencarian desktop default dari dalam pencarian itu. |
| inputlocale | Tidak | Saat ini tidak digunakan. |
| kata kuncilocale | Tidak | Saat ini tidak digunakan. |
| sintaksis | Tidak | Saat ini tidak digunakan. |
| stackedby | Tidak | Saat ini tidak digunakan. |
| nama tampilan | Tidak | Saat ini tidak digunakan. |
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
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:
- Tulis ProgID ke HKEY_LOCAL_MACHINE, seperti yang dijelaskan di bawah ini. Perhatikan bahwa aplikasi harus membuat ProgID khusus aplikasi untuk protokol pencarian.
- Klaim asosiasi protokol pencarian tingkat mesin.
- Daftarkan aplikasi dengan Program Default, seperti yang dijelaskan dalam Mendaftarkan Aplikasi untuk Digunakan dengan Program Default, sebagai pilihan untuk protokol pencarian.
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"