Aracılığıyla paylaş


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

Arama protokolü aşağıdaki standart URL kodlanmış söz dizimini kullanır:

search:parameter=value[&parameter=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 storeuygulaması 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:

  1. 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.
  2. Makine düzeyinde arama protokolü ilişkilendirmesini talep edin.
  3. 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"

gelişmiş sorgu söz dizimi

Varsayılan Programlar