Yerel sipariş karşılama

Local Home SDK'sı, akıllı evinizin Google ile entegrasyonunu iyileştirir Rotaya yerel bir sipariş karşılama yolu ekleyerek Asistan akıllı ev amaçları.

SDK, TypeScript veya JavaScript kullanarak yerel bir sipariş karşılama uygulaması yazmanıza akıllı ev iş mantığınızı içerir. Google Home veya Google Nest cihazları, uygulamanızı cihaz üzerinde çalıştırmaktır. Uygulamanız, mevcut akıllı cihazlarınızla doğrudan iletişim kurar kullanıcı komutlarını yerine getirmek için yerel ağda (LAN) kablosuz bağlantı üzerinden cihazlar çok daha iyidir.

SDK entegrasyonu, akıllı evinizde performans iyileştirmeleri sunar Daha düşük gecikme ve daha yüksek güvenilirlik gibi işlem. Yerel sipariş karşılama tüm cihaz türleri ve cihaz özellikleri için desteklenir ikincil kullanıcı doğrulama başlıklı makaleyi inceleyin.

Derlemeye başlayın Örneği deneyin

İşleyiş şeklini anlayın

SYNC yanıtı aldıktan sonra Yerel Ev platformu, kullanıcılarınızın temel incelemelerini keşif yapmak için mDNS, UDP yayını veya UPnP kullanan yerel ağ Asistan'a bağlı akıllı cihazlar.

Platform, cihazın çalışıp çalışmadığını belirlemek için bir IDENTIFY niyeti gönderir. IDENTIFY yanıtındaki cihaz kimliğini karşılaştırarak yerel olarak kontrol edilebilir önceki SYNC yanıtı tarafından döndürülen URL'lere. Algılanan cihaz bir platform, bir REACHABLE_DEVICES amacı gönderir ve hub'ını kullanarak yerel olarak iletişim kurmanızı sağlar.

Yerel bir cihazı onaylayan bir yanıt aldığında platform, Kullanıcının Google Home veya Google Nest cihazına giden yerel bir sipariş karşılama yolu ve ardından yerel sipariş karşılama için kullanıcı komutları.

Bir kullanıcı, yerel sipariş karşılama yolu olan bir akıllı ev işlemini tetiklediğinde Asistan, EXECUTE mesajını gönderir amacı veya QUERY amacını Google Home veya Google Nest cihazı tercih edilmelidir. Ardından, cihaz amacı işlemek için yerel sipariş karşılama uygulamasını çalıştırır.

Yerel Ev platformu, hangi Google Home veya Google Nest cihazının seçileceği konusunda belirleyici değildir. komutu tetikler. EXECUTE ve QUERY amaçları herhangi bir kaynaktan gelebilir Aynı Home Graph'te tanımlanmış Google Home veya Google Nest cihazı yapıyı seçin.

Yerel sipariş karşılama uygulaması

Yerel sipariş karşılama uygulaması, Google Ads tarafından gönderilen niyetlerin Yerel Ev platformunu ziyaret edebilir ve akıllı cihazınıza yerel ağ üzerinden erişebilirsiniz. Yerel sipariş karşılamayı entegre etmek için donanımınızda herhangi bir değişiklik beklenmiyor. İlgili içeriği oluşturmak için kullanılan uygulaması, kontrol komutlarını HTTP, TCP veya UDP dahil olmak üzere uygulama katmanı protokolleri aracılığıyla akıllı cihaza Yerel sipariş karşılama yolunun başarısız olması durumunda bulut sipariş karşılama yönteminiz kullanılır. olarak ayarlayın.

Local Home SDK'sı, uygulamanın derlenmesini desteklemek için aşağıdaki iki ana özelliği sunar: sınıflar:

• DeviceManager: Akıllı cihazlarla iletişim kurmak için aşağıdakileri kullanarak yöntemler sunar: TCP, UDP yuvaları veya HTTP istekleri.
• App: Google'ın gönderdiği amaçlar için işleyici ekleme yöntemleri sağlar yerel olarak kontrol edilebilen cihazları keşfettikten sonra (IDENTIFY, REACHABLE_DEVICES) tıklayın. Bu sınıf, kullanıcı komutlarını (EXECUTE) ve Mevcut cihaz durumuyla ilgili kullanıcı sorgularını yanıtlar (QUERY).

Geliştirme sırasında uygulamayı kendi başınıza yükleyerek oluşturabilir ve test edebilirsiniz. barındırma sunucusu veya yerel geliştirme makinesidir. Üretim aşamasında Google, kullanıcının Google Home veya Google Nest cihazındaki güvenli bir JavaScript korumalı alanı ortamında uygulamanızı sağlar.

Rapor Durumu API'si şu anda yerel sipariş karşılama için desteklenmiyor. Google buluttaki istek karşılamayı da kullanabilirsiniz.

Uygulama yaşam döngüsü

Yerel sipariş karşılama uygulamanız, Yerel Ev platformu şurada bulunduğunda talep üzerine yüklenir: proje tarama yapılandırmasıyla eşleşen veya beklemede olan yeni yerel cihazlar daha önce tanımlanmış bir cihazla ilgili teslim etme niyeti.

Google Home veya Google Nest cihazlarının belleği kısıtlı ve yerel sipariş karşılama uygulamanız sistemdeki bellek baskısı nedeniyle herhangi bir anda sonlandırılabilir. Bu uygulamanız çok fazla bellek kullanmaya başladığında veya sistemin yer açın. Yerel Ev platformu, uygulamanızı yalnızca ve uygulamanın çalışması için yeterli bellek kaynağı sunmalıdır.

Yerel Ev platformu, kullanıcı boşta kalma zaman aşımından sonra uygulamanızı kaldırır. veya yerel Google Chrome'u destekleyen cihazların olmaması kullanıcının agentUserId ile ilişkili sipariş karşılama.

Desteklenen cihazlar

Yerel Ev platformu, yerel sipariş karşılama uygulamanızı desteklenen Google Home veya Google Nest cihazlar. Aşağıdaki tabloda, desteklenen cihazlar açıklanmaktadır ve her cihazda kullanılan çalışma zamanıdır. Çalışma zamanı gereksinimleri hakkında daha fazla bilgi için Yürütme ortamı.

Cihaz	Tür	Ortam
Google Home	Hoparlör	Chrome
Google Home Mini	Hoparlör	Chrome
Google Home Max	Hoparlör	Chrome
Nest Mini	Hoparlör	Chrome
Nest Hub	Görüntülü Reklam Ağı	Chrome
Nest Hub Max	Görüntülü Reklam Ağı	Chrome
Nest Wifi	Yönlendirici	Node.js
	Nokta	Chrome

Yürütme ortamı

Yerel sipariş karşılama uygulamanızın yürütme ortamı, cihaz. Local Home platformu şunları destekler: çalışma zamanı ortamları:

• Chrome: Yerel sipariş karşılama uygulamanız bir Chrome bağlamında yürütülüyor tarayıcı window Chrome çalıştırıyor M80 veya daha sonra ECMAScript sürümü ES2018.
• Node.js: Yerel sipariş karşılama uygulamanız, Node.js içinde bir komut dosyası olarak yürütülür Düğüm v10.x çalıştıran işlem LTS veya daha sonra ECMAScript sürümü ES2018.

Kaynak kodu yapısı

Bağımlılıklarınızı paketleyici yapılandırmaları tarafından sağlanmış olması ve kaynak kodunuzun Hemen çağrılan İşlev İfadesi (IIFE).

Uygulama yolu

Akıllı ev entegrasyonunuz için Local Home SDK'sını kullanmak istiyorsanız şunları yapmanız gerekir: şu görevleri gerçekleştir:

1	Taramayı ayarlayın yapılandırma	İşlemler konsolunu, Asistan'ın yerel olarak kontrol edilebilen cihazları keşfetmesini sağlayın.
2	Bulut temininizde yanıtı senkronize edin	Bulut temininizde SYNC. Platformun Search Ads 360'ı oluşturmak için kullandığı otherDeviceIds alanı yerel sipariş karşılama rotası. Bu alanda, yerel olarak kontrol ediliyor.
3	yerel sipariş karşılama uygulaması	Aşağıdakileri yapmak için bir JavaScript uygulaması oluşturmak üzere Local Home SDK'sını kullanın: IDENTIFY, EXECUTE ve QUERY niyet. Hub veya köprü proxy cihazları için REACHABLE_DEVICES amacını da işleyebilir.
4	Uygulamanızı test etme ve hata ayıklama	Şu bağlantıyı kullanarak entegrasyonunuzu test edin (veya içerik üretici onayı sağlayın): Google Home Test Paketi.

Başlamadan önce

• Akıllı ev oluşturmayla ilgili temel bilgileri öğrenin. İşlem.
• İşlemler konsolu, Mevcut bir akıllı ev projeniz olduğundan ve hesap bağlamanın yapılandırıldı.
• Şurada aynı Google Hesabı ile giriş yaptığınızdan emin olun: Test cihazınızdaki Actions konsolunda ve Asistan'da.
• Node.js kitaplığına ihtiyacınız olacak bir ortama sahip olmanız gerekir. Node.js ve npm'yi yüklemek için Düğüm Sürümü Yönetici önerilir.
• Local Home SDK'sının son sürümüyle çalışmak için şunları yapmanız gerekir: test cihazlarınızı Yayın Önizlemesi'ne kaydedin Program'ı tıklayın.