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.

Uygulamanızı test etme ve hata ayıklama

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

Yerel sipariş karşılama uygulamanızı daha önce açıklanan adımları kullanarak oluşturmanızı, ardından aşağıdaki adımları uygulayarak akıllı ev entegrasyonunuzu kendi barındırma ortamınızda test etmenizi öneririz:

  1. Kendi barındırma ortamınızda, yerel sipariş karşılama uygulamanızı çalıştıran HTML sayfasını sunun. Aşağıdaki snippet'te, yerel sipariş karşılama uygulamanızı çalıştıran statik bir HTML dosyası örneği gösterilmektedir.

    <html>
      <head>
        <!-- Local Home SDK -->
        <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
        <!-- Local app under development -->
        <script src="local_execution.js"></script>
      </head>
    
    </html>
    
    
  2. Cihaz denetimini test edin.

  3. Chrome'da hata ayıklayın. Entegrasyonunuzla ilgili sorunları gidermek için ayrılma noktalarını ve günlükleri kullanın.

  4. TypeScript kodunuzu değiştirip derleyip bu adımları tekrarlayın.

Bu derleme ve test işlemini tekrarlayarak değişikliklerinizle ilgili işlemleri hızlı ve daha kolay bir şekilde görüp kodunuzdaki sorunları giderebilirsiniz.

Cihaz kontrolünü test edin

İşlem konsolunda web uygulamanızın URL'sini belirtmeniz gerekir. Web uygulamanızın yerel karşılama sırasında Google Home veya Google Nest cihazına yüklenen HTML'si sunulur.

Yerel karşılama ile cihaz kontrolünü test etmek için şu adımları uygulayın:

Chrome

  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ı) > Chrome için test URL'nizi girin altında, yerel sipariş karşılama uygulamanızı çalıştıran HTML'yi sunan geliştirme sunucusu URL'sini belirtin.
  4. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi yayması 30 dakika kadar sürebilir.
  5. Test Google Home veya Google Nest cihazınızı yeniden başlatın.
  6. Akıllı cihazınıza bir komut verin. Örneğin, cihazınız OnOff özelliğini uyguluyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

Node.js

  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ı) > Düğüm için test URL'nizi girin altında, yerel sipariş karşılama uygulamanızı çalıştıran JavaScript'i sunan geliştirme sunucusu URL'sini belirtin.
  4. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi yayması 30 dakika kadar sürebilir.
  5. Test Google Home veya Google Nest cihazınızı yeniden başlatın.
  6. Akıllı cihazınıza bir komut verin. Örneğin, cihazınız OnOff özelliğini uyguluyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

Cihazınızın hangi çalışma zamanı tarafından kullanıldığı hakkında daha fazla bilgi için Desteklenen cihazlar bölümüne bakın.

Chrome'da hata ayıklama

Chrome Geliştirici Araçları'nı kullanarak yerel sipariş karşılama uygulamanızda hata ayıklayabilirsiniz. Hata ayıklama yapmadan önce ortamınızın doğru şekilde ayarlandığından emin olun:

  • Konsolda, geliştirme URL'nizi Google Home veya Google Nest cihazı (yerel alan ağı veya internet üzerinden) tarafından erişilebilen bir URL olarak ayarladınız
  • Makineniz, test ettiğiniz Google Home veya Google Nest cihazı ile aynı yerel alan ağına bağlı olmalıdır.
  • Ağınız cihazlar arasındaki paketleri engellemez.
  • Actions konsolunda ve Google Home veya Google Nest cihazında aynı Google hesabıyla giriş yaptınız.
  • Bulut karşılamanızdaki SYNC yanıtını güncellediniz. otherDeviceIds alanında en az bir geçerli değer döndürmelidir.
  • Actions Console'da doğru tarama yapılandırması bilgilerini girdiniz.

Yerel sipariş karşılama uygulamanızı Chrome DevTools hata ayıklayıcısına bağlamak için aşağıdaki adımları uygulayın:

Chrome

  1. Yerel geliştirme makinenizde Google Chrome tarayıcıyı yükleyin ve başlatın.
  2. Chrome tarayıcınızın adres alanına şu adresi girerek Chrome denetleyiciyi başlatın: chrome://inspect#devices. Sayfada cihazların listesi olmalı ve HTML dosyanız, test Google Home veya Google Nest cihazınızın adı altında listelenmelidir.
  3. Chrome Geliştirici Araçları'nı başlatmak için HTML'nizin altındaki mavi denetleme bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Home platformu, konsol günlüğünde uygulama sürümünüzü ve Yerel Ev SDK sürümünü oluşturur. Günlüğü görüyorsanız bu, Google'ın uygulamanızı başarıyla yüklediği ve uygulamaya bağlanabileceği anlamına gelir. Çalışmıyorsa Google Home veya Google Nest cihazınızı yeniden başlatın.
  4. Şekil 1: chrome://inspect'teki yerel sipariş karşılama uygulaması.

Node.js

  1. Yerel geliştirme makinenizde Google Chrome tarayıcıyı yükleyin ve başlatın.
  2. Test cihazınızın yerel IP adresini belirleyin.
  3. Chrome tarayıcınızın adres alanına şu adresi girerek Chrome denetleyiciyi başlatın: chrome://inspect#devices.
  4. Hedef Keşif... seçeneğini belirleyerek Hedef keşif ayarları'nı açın.
  5. Şekil 2: chrome://inspect'teki keşif ayarları hedefi.
  6. Listeye DEVICE_IP_ADDRESS:9222 yazın ve Bitti'yi tıklayın.
  7. Chrome Geliştirici Araçları'nı başlatmak için komut dosyanızın altındaki mavi denetleme bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Home platformu, konsol günlüğünde uygulama sürümünüzü ve Yerel Ev SDK sürümünü oluşturur. Günlüğü görüyorsanız bu, Google'ın uygulamanızı başarıyla yüklediği ve uygulamaya bağlanabileceği anlamına gelir. Çalışmıyorsa Google Home veya Google Nest cihazınızı yeniden başlatın.

Cihazınız tarafından hangi çalışma zamanının kullanıldığı hakkında daha fazla bilgi için Desteklenen Cihazlar bölümüne bakın.

Hata ayıklama ipuçları

Hata ayıklama sırasında aklınızda bulundurmanız gereken bazı ek noktalar şunlardır:

  • Aynı yerel ağdaki test hesabınıza birden fazla Google Home veya Google Nest cihazı bağlamayın. Yerel sipariş karşılama komutlarıyla hangi Google Home veya Google Nest cihazının hedeflendiğini kontrol edemezsiniz.
  • Yerel karşılama uygulaması kapsayıcınızı, geliştirme URL'nizdeki en son kodla yeniden yüklemek için Chrome Geliştirici Araçları'nda sayfayı yenileyin. Bu işlem, yerel sipariş uygulamanızda platform amaçlarını (IDENTIFY gibi) yeniden tetiklemek için gerekli olabilecek Yerel Ev platformunu sıfırlamaz. Yerel Ev platformunu sıfırlamak için Google Home veya Google Nest cihazınızı yeniden başlatın.
  • JavaScript uygulamanızın hatasız olarak yüklenip yüklenmediğini kontrol edin. Bunu yapmak için Geliştirici Araçları sayfasının konsol bölümüne göz atın. Sorun olursa şunun gibi bir mesaj görürsünüz: Uncaught TypeError: Cannot read property ‘open’ of null.
  • IDENTIFY yanıtındaki verificationId, SYNC yanıtındaki otherDeviceIds ile eşleşmelidir.
  • EXECUTE işleyicisi için HTTP, TCP veya UDP komutlarınızın cihazınız tarafından alınabildiğinden ve beklendiği gibi çalıştığından emin olun.
  • İşleyicilerden Promise döndürdüğünüzden emin olun.
  • Genel belleğin bellekte kalmasını önleme. Uygulama yaşam döngüsü bölümünü inceleyin.
  • Yerel sipariş karşılama uygulamanız tarafından yapılan hatalar, proje hata günlüklerinizde görünür.

Hazırlık ve üretime sunma

Akıllı ev Action'ınızı başlatmaya hazır olduğunuzda şu adımları uygulayın:

  1. Bir terminal penceresi açın. Proje dizininizde npm run build komutunu çalıştırın. Bu komut, dist dizininiz için uygulamanız için aşağıdaki JavaScript paketlerini oluşturur:
    project-directory/
    └── dist
     ├── web
     │    └── bundle.js
     └── node
          └── bundle.js
    
  2. Konsolda JavaScript uygulamanızı Geliştir > İşlemler'i tıklayarak yükleyin. Yerel Ev SDK'sını yapılandırın bölümünde, JavaScript dosyalarını yükle'yi tıklayın.
    Şekil 3: JavaScript uygulamanızı yükleyin.
  3. Dosyaları yükle iletişim kutusunda, daha önce oluşturduğunuz paket dosyalarını yükleyin. İşleminizin yerel sipariş karşılamanın desteklediği tüm çalışma zamanı ortamlarında düzgün çalışacak şekilde yapılandırılması için paket dosyalarının her iki sürümünü de (Düğüm, Web) yüklediğinizden emin olun.
    1. Düğüm.js'yi hedefleyen JavaScript'inizi yükleyin: bundle.js dosyasını dist/node dizininden yükleyin.
    2. Chrome'u (JavaScript) hedefleyen JavaScript'inizi yükleyin: bundle.js dosyasını dist/web dizininden yükleyin.
  4. İşleminizi Asistan özellikli bir cihazda test ederek üretim ortamında beklendiği gibi davrandığını doğrulayın. Daha fazla bilgi için Akıllı ev işleminizi test etme ve paylaşma başlıklı makaleyi inceleyin.
  5. İşleminizin çalışma şeklinden memnun kaldıysanız Akıllı ev işleminizi başlatma talimatlarını uygulayarak bunu üretim dağıtımı için Google'a gönderin. Buna, kendi kendine test ve sertifika isteği adımlarını tamamlamak da dahildir.