Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Cihaz keşfini destekleme

Google, buluttaki sipariş karşılama özelliğinin SYNC yanıtında döndürülen ve yerel olarak kontrol edilebilir bir cihazı eşleştirdiğinde yerel bir sipariş karşılama yolu oluşturulur.

Google'ın cihazınızı yerel ağda keşfetmesini ve yerel sipariş karşılama yolunu belirlemesini sağlamak için Actions konsoluna keşif bilgileri eklemeniz gerekir. Ayrıca, Google'a yerel olarak kontrol edilebilir cihaz hakkında bilgi vermek için buluttaki sipariş karşılama üzerinden sağlanan SYNC yanıtını güncellemeniz gerekir.

Tarama yapılandırması bilgilerini ayarlama

Keşif bilgilerini belirtmek için şu adımları uygulayın:

  1. Actions konsolunda akıllı ev projenizi açın.
  2. Sol gezinme menüsünde İşlemler'i tıklayın.
  3. Yerel ev SDK'sını yapılandır (isteğe bağlı) > Cihaz tarama yapılandırması ekle bölümünde, Yeni tarama yapılandırması'nı tıklayın.
  4. Açılır listeden bir tarama eşleştirme protokolü türü seçin ve Google'ın taraması için değerler girin.

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

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

Zorunlu. instance.service.domain biçimindeki benzersiz hizmet örneğini filtreleyin.

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

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

Cihaz üreticisini tanımlayan 24 bit değer. Genellikle cihazın MAC adresinin ilk üç sekizliği.
1A:2B:3C
UDP
Özellik Açıklama Örnek Değer
Yayın Adresi Zorunlu. UDP yayınının hedef IP adresi. 255.255.255.255
Yayın Bağlantı Noktası Zorunlu. UDP yayınının hedef bağlantı noktası. 5555
Dinleme Bağlantı Noktası 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ış baytlardan oluşan bir dize olarak biçimlendirilir.
48454C4C4F

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

SYNC amacı, Asistan'a kullanıcının hangi cihazları ve işlevlerini kontrol ettiğini bildirir.

Yerel ev platformu, yerel istek karşılamayı desteklemek için akıllı ev işleminizin Cloud istek karşılamasından gelen SYNC yanıtını kontrol eder ve otherDeviceIds alanındaki cihaz kimliklerini, IDENTIFY işleyicinin döndürdüğü doğrulama kimliğiyle eşleştirmeye çalışır. otherDeviceIds alanı olmayan cihaz girişleri yerel istek karşılamanın dışında tutulur.

SYNC yanıtının otherDeviceIds alanında, yerel olarak kontrol edilebilen akıllı ev cihazlarının cihaz kimliklerini ayarlamanız gerekir. Alan, yanıtta device düzeyinde görünür. Google, belirtilen kimliğe sahip herhangi bir cihazda yerel sipariş karşılama yolu oluşturabilir.

Google'ın bağımsız bir cihaza bağlaması gereken son verileri belirtmek veya son cihazları bir merkez aracılığıyla hedeflemek (ör. bağlantı noktası numarası ve protokole özel diğer bilgiler) için customData alanını kullanın.

Ö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": "..."
      }
    }]
  }
}