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:
- Actions Console'da akıllı ev projenizi açın.
- Soldaki gezinme bölmesinde İşlemler'i tıklayın.
- 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.
- 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:
| Ö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. |
my-device-[0-9]{4}\._http\._tcp\.local |
| Ö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 |
| Ö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.
{
"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": "..."
}
}]
}
}