Arama Protokollerini Kullanma
arama:uygulama protokolü, Windows Vista Service Pack 1 (SP1) ve sonraki sürümlerde masaüstü arama uygulamasını çağırmaya yönelik genişletilebilir bir kuraldır. Protokol, Windows'a varsayılan masaüstü arama uygulamasını belirlemek ve çağırmak için bir yol sağlamak için SP1 ile Windows Vista'da oluşturulmuştur.
Protokol söz dizimi, kullanıcı tarafından girilen arama terimleri veya aramanın başlatıldığı konum gibi yaygın masaüstü aramaları gerçekleştirmek için yararlı olan bir dizi parametre sağlar. Kullanıcılar kullanılabilir iki arama giriş noktasından birinde arama yaparken (Başlangıç menüsü veya Windows Gezgini), işletim sistemi varsayılan masaüstü arama uygulamasını başlatmak için arama protokollerini kullanır. Bunu, kullanıcı tarafından girilen arama terimlerini standart arama protokolü söz dizimine ekleyerek ve bu bilgileri varsayılan arama uygulaması olarak kaydedilen uygulamaya geçirerek yapar.
Başka masaüstü arama uygulaması yüklü değilse, bu giriş noktalarına girilen bir arama Windows Arama Gezgini'ni başlatır. Ancak üçüncü taraf geliştiriciler, arama protokolünü işlemek ve varsayılan arama uygulaması olmak üzere uygulamalarını oluşturabilir, yükleyebilir ve kaydedebilir. Bu tür uygulamaların, Windows ile sorunsuz bir deneyim sağlamak için arama protokolü söz dizimini desteklemesi ve Varsayılan Programlar özelliğine kaydolması gerekir.
Belirli bir masaüstü arama uygulamasını kullanmak veya üzerinde derlemek üzere bir uygulama geliştirirseniz, yalnızca arama: protokolüne bağımlı olmamalıdır. birçok uygulama aramaya sahip olabileceğinden: protokolü, hedeflenen masaüstü arama uygulamanızın herhangi bir zamanda buna sahip olacağının garantisi yoktur. Bunun yerine, hedeflenen masaüstü arama uygulaması tarafından tanımlanan özel bir arama protokolü kullanmanız gerekir. Bu, üçüncü taraf uygulamalar için bir platform olması amaçlanan masaüstü arama uygulamalarının hem aramayı desteklemesi gerektiği anlamına gelir: protokolü hem de kendi özel arama protokolleri.
Not
arama: protokolü, özel search-ms: protokollerinin yerini almaz. Uygulamalar, Windows Arama Gezgini'ni başlatmak veya Windows Search dizin oluşturucusunu sessizce sorgulamak için search-ms: protokollerini kullanmaya devam edebilir.
Bu konu aşağıdaki konuları kapsar:
- Sözdizimi
- Windows Vista'yı SP1 ile arama: protokol
- Örnekleri
- Protokol İşleyen Uygulamayı Kaydetme
- İlgili konular
Sözdizimi
Arama protokolü aşağıdaki standart URL kodlanmış söz dizimini kullanır:
search:parameter=value[¶meter=value]&
Söz dizimi, protokolün kendisini tanımlayarak başlar (arama:). Parametre/değer çiftleri, arama protokolü söz dizimi için tüm olası parametrelerin gösterildiği aşağıdaki tabloda açıklandığı gibi Arama motoruna geçirilen bağımsız değişkenlerdir.
Parametre | Değer | Açıklama |
---|---|---|
sorgu | URL ile kodlanmış metin | Kullanıcı tarafından girilen sorgu metni. |
inputlocale | Geçerli bir dil kodu tanımlayıcısı (LCID) | Sorgunun giriş dilini tanımlayan LCID. |
keywordlocale | Geçerli herhangi bir LCID | Indexer'ın uluslararası sürümünün dilini tanımlayan LCID. Varsayılan değer 1033 'tür (en-us). |
kırıntı | AQS deyimi | Bu argüman, aranan kapsamı kısıtlar. Windows Vista'da arama protokolü, tam AQS'yi ve location bağımsız değişkeni için özel bir uygulamayı destekler. Windows XP'de arama protokolü, özel bir kind ve store uygulaması dışında tam AQS'yi de destekler. |
söz dizimi | NQS, AQS (büyük/küçük harfe duyarlı değil) | Dizinde arama yapmak için kullanılacak sorgu söz dizimi: Doğal Sorgu Söz Dizimi veya Gelişmiş Sorgu Söz Dizimi (AQS). AQS varsayılandır ve her zaman ayrıştırılır ve desteklenir. |
stackedby | Özellik sisteminde tanımlı herhangi bir geçerli özellik | Sonuçları yığmak için kullanılacak sütunu belirten bir özellik. |
alt sorgu | Kaydedilmiş Arama dosyası (*.search-ms) için tam olarak belirtilen yol | Alt sorgunun sonuçları sorgunun kaynağı olarak kullanılır. Başka bir ifadeyle, sorgu terimleri alt sorgunun sonuçlarına göre aranılır. |
görünen ad | URL ile kodlanmış dize | Geçerli aramanın adı. |
Arama: protokolünün SP1 ile Windows Vista kullanımı
SP1 ile Windows Vista' nın aramasını çağırdığı birkaç giriş noktası vardır: protokolü. Bu giriş noktaları, her biriyle ilişkilendirilmiş ortak söz diziminin yanı sıra aşağıda özetlenmiştir.
Arama protokolü giriş noktası | Yer | Sorgu çalıştırıldı |
---|---|---|
Her Yerde Ara | Başlat menüsü | search:query=<Arama Terimi> |
Her Yerde Ara | Windows Dosya Gezgini | search:query=<Arama Terimi>&crumb=location:<LOCATION> |
Windows logo tuşu+F | Herhangi bir yer | aramak: |
CTRL+F | Windows Gezgini | search:query=<Arama Terimi>&crumb=location:<LOCATION> |
F3 | Başlat menüsü | ara: |
F3 | Windows Gezgini | search:query=<Arama Terimi>&crumb=location:<LOCATION> |
SP1 ile Windows Vista arama protokolü giriş noktaları, arama protokolündeki tüm olası parametrelerden yararlanmaz. Yalnızca SP1 ile Windows Vista'dan gelen arama protokolü çağrılarını işlemeyle ilgilenen uygulamalar, aşağıdaki tabloyu uygulamak için gereken en düşük kılavuz olarak kullanabilir.
Parametre | Windows tarafından mı kullanılır? | SP1 ile Windows Vista, aramayı çağırırken nasıl kullanır: |
---|---|---|
sorgu | Evet | Kullanıcı tarafından girilen sorgu metni. |
kırıntı | Evet |
kırıntı, sorgunun nereden geldiğini belirtmek için location bağımsız değişkenini kullanır. |
Alt sorgu | Evet | Alt Sorgu bağımsız değişkeninin sonuçları, aranacak öğelerin kapsamı olarak kullanılır. Bu genellikle bir kullanıcı bir arama yapmak için .search-ms dosyasını kullandığında ve ardından bu aramanın içinden varsayılan masaüstü arama uygulamasını çalıştırdığında kullanılır. |
inputlocale | Hayır | Şu anda kullanılmıyor. |
keywordlocale | Hayır | Şu anda kullanılmıyor. |
söz dizimi | Hayır | Şu anda kullanılmıyor. |
üst üste yığılmış | Hayır | Şu anda kullanılmıyor. |
görünen ad | Hayır | Şu anda kullanılmıyor. |
Örnekler
Bir kullanıcı Başlat menüsüne "Microsoft" girer ve Her Yerde Aratıklarsa, sonuçta elde edilen arama protokolü çağrısı yapılır.
search:query=microsoft&
Bir kullanıcı C:\MyFolder içinde Windows Gezgini'ne "Seattle" girer ve ardından Her Yerde Ara'e tıklarsa, ':' ve '\' için kaçış karakterleri kullanılarak aşağıdaki çağrı yapılır:
search:query=seattle&crumb=location:C%3A%5CMyFolder
Protokolü İşleyen Uygulamayı Kaydetme
Birden çok uygulama arama protokolü için başvurabildiğinden, kullanıcının varsayılanı daha kolay yapılandırabilmesi için yükleme sırasında uygulamanızı varsayılan programlar özelliğine kaydetmeniz gerekir. Normalde Windows XP altında uygulanan yükleme yordamlarına ek olarak, Windows Vista tabanlı bir uygulamanın ve kullanıcıların varsayılanları sorunsuz bir şekilde yapılandırabilmesi için Varsayılan Programlar özelliğine kaydolması gerekir.
Kullanıcının bilgisayarına gerekli ikili dosyaları yükledikten sonra, yükleme yordamınız şu genel görevleri tamamlamalıdır:
- ProgID'leri aşağıda açıklandığı gibi HKEY_LOCAL_MACHINEyazın. Uygulamaların arama protokolü için uygulamaya özgü ProgID'ler oluşturması gerektiğini unutmayın.
- Makine düzeyinde arama protokolü ilişkilendirmesini talep edin.
- Uygulamayı Varsayılan Programlarile, Varsayılan Programlarla Kullanmak üzere Kaydetmebaşlıklı bölümde açıklandığı gibi, arama protokolü için bir aday olarak kaydedin.
Kayıt Defteri Girdileri
Aşağıda, contoso Search adlı kurgusal bir masaüstü arama uygulaması için gerekli kayıt defteri girdilerine örnekler verilmiştir.
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"
İlgili konular