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

Cihaz keşfini destekleme

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yerel sipariş karşılama yolu, bulut tarafından sipariş karşılama işleminden elde edilen SYNC yanıtında döndürülen, yerel olarak kontrol edilebilir bir cihazla eşleştiğinde 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 işlem bilgileri eklemeniz gerekir. Ayrıca, Google'a yerel olarak kontrol edilen cihaz hakkında bilgi vermek için bulut karşılamanızın SYNC yanıtını güncellemeniz gerekir.

Tarama yapılandırması bilgilerini ayarlama

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

  1. Actions Console'da akıllı ev projenizi açın.
  2. Soldaki gezinme bölmesinde İş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 menüden tarama tarama protokolü türünü 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 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çiminde tam nitelikli tanımlayıcısı. schemas-upnp-org:service:SwitchPower:1
RSK

İ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ının dinleme bağlantı noktası. 5556
Keşif Paketi

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

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

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

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

Yerel Ev platformu, yerel sipariş karşılamayı desteklemek için akıllı ev Action'ınızın bulut karşılama işleminden gelen SYNC yanıtını kontrol eder ve otherDeviceIds alanındaki cihaz kimliklerini IDENTIFY işleyici tarafından döndürülen doğrulama kimliğiyle eşleştirmeye çalışır. otherDeviceIds alanı olmayan cihaz girişleri yerel sipariş karşılamadan hariç 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ıttaki device düzeyinde görünür. Google, belirtilen kimliğe sahip tüm cihazlarda yerel bir sipariş karşılama yolu oluşturabilir.

Google'ın bağımsız bir cihaza bağlaması gereken ek verileri belirtmek veya bir uç aracılığıyla (örneğin, bağlantı noktası numarası ve protokole özel diğer bilgiler) son cihazları hedeflemek 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": "..."
      }
    }]
  }
}