Cihaz keşfini destekleme

Google, yerel olarak kontrol edilebilen bir cihazla eşleştiğinde yerel sipariş karşılama yolu oluşturulur. SYNC içinde iade edilen bir cihaza en iyi uygulamaları paylaşacağız.

Google'ın cihazınızı yerel ağ üzerinde bulmasını ve yerel sipariş karşılama yolu için Actions Console'da keşif bilgilerini eklemeniz gerekir. Ayrıca, şunlara izin vermek için bulut yetkilendirmenizden SYNC yanıtını güncellemeniz gerekir: Google, yerel olarak kontrol edilebilen cihaz hakkında bilgi sahibidir.

Tarama yapılandırması bilgilerini ayarlama

Keşif bilgilerini belirtmek için aşağıdaki adımları uygulayın:

  1. Actions konsolunda akıllı ev projenizi açın.
  2. Soldaki gezinme panelinde İşlemler'i tıklayın.
  3. Yerel ana sayfa SDK'sını yapılandır (isteğe bağlı) bölümünde > Add device tarama configuration (Cihaz tarama yapılandırması ekle) ve New scan config'i (Yeni tarama yapılandırması) tıklayın.
  4. Açılır menüden tarama eşleştirme protokolü türü seçin ve Taranacak Google.

Aşağıdaki tablolarda, protokollere bağlı olarak ekleyebileceğiniz özellikler gösterilmiştir Cihazınızı taramak için Google'ın kullanmasını istediğiniz uygulama:

mDNS
Özellik Açıklama Örnek Değer
Hizmet Adı Zorunlu. Cihaz tarafından yayınlanan şunun biçimindeki hizmet adı: service.domain _http._tcp.local
Ad

Zorunlu. Şurada benzersiz bir hizmet örneği için filtreleyin: instance.service.domain biçimindedir.

Platform, bu değeri normal ifade olarak değerlendirir ve eşleşen cihaz var. 		my-device-[0-9]{4}\._http\._tcp\.local
ziyaret edin.
UPnP
Özellik Açıklama Örnek Değer
Hizmet Türü Zorunlu. UPnP hizmetinin biçimdeki tam nitelikli tanımlayıcısı domain:service:type:version schemas-upnp-org:service:SwitchPower:1
OUI

İsteğe bağlı. Kuruluş Genelinde Benzersiz Tanımlayıcı.

Cihaz üreticisini tanımlayan 24 bit değeri. Genellikle, cihazın MAC adresinin ilk üç sekizliği. 		1A:2B:3C
ziyaret edin.
UDP
Özellik Açıklama Örnek Değer
Yayın Adresi Zorunlu. UDP yayını için hedef IP adresi. 255.255.255.255
Yayın Bağlantı Noktası Zorunlu. UDP yayını için hedef bağlantı noktası. 5555
Bağlantı noktasını dinle Zorunlu. UDP keşif yanıtı için dinleme bağlantı noktası. 5556
Keşif paketi

Zorunlu. UDP yayınında gönderilecek yük.

Onaltılık olarak kodlanmış bayt dizesi olarak biçimlendirilir. 		48454C4C4F

Bulut karşılamada SYNC yanıtını güncelleme

SYNC intent, Kullanıcının kontrol ettiği cihazlar ve yetenekleri Asistan.

Yerel Ev platformu, yerel sipariş karşılamayı desteklemek için SYNC yanıtını kontrol eder akıllı evinizin Action'ının buluttaki karşılamasından çıkar ve cihazı eşleştirmeye çalışır. otherDeviceIds alanındaki kimlikler tarafından döndürülen doğrulama kimliğine IDENTIFY işleyici. otherDeviceIds alanı olmayan cihaz girişleri: yerel sipariş karşılama kapsamından çıkarılmıştır.

otherDeviceIds SYNC yanıtının cihaz kimliklerini ayarlamak için akıllı evin cihaz kimliklerini ayarlamanız gerekir cihazlar yerel olarak kontrol edilebilir. Bu alan device düzeyinde görünür kullanıcı olabilir. Google, Google Haritalar API'lerini kullanan herhangi bir cihazda verilen kimliği belirtir.

Google'ın ihtiyaç duyduğu ek verileri belirtmek için customData alanını kullanın veya bir hub aracılığıyla son cihazları hedeflemek (örneğin, bağlantı noktası numarası ve protokole özgü diğer bilgiler).

Örnek

Aşağıdaki snippet'te SYNC işleyicinizi nasıl oluşturabileceğiniz gösterilmektedir.

Bağımsız/Merkez
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}
Önceki
Genel bakış
Sonraki
Yerel sipariş karşılama uygulamasını uygulayın