Home API'lerini Android uygulamanıza ekleme

Home API'leri bir Android uygulamasına eklemek için birkaç ön koşulu karşılamanız gerekir.

Ön koşullar

Geliştirme için aşağıdaki araçların yüklü olduğu bir bilgisayar gerekir:

  • Android Studio, sürüm 2024.2.1 ("Ladybug") veya sonraki sürümler. Bu sürümden önceki sürümlerin Home API'leri SDK'sı ile düzgün çalışmayabileceğini unutmayın.

    Android Studio'yu indirin

  • Android hata ayıklayıcısı (adb).

    Yükle adb.

    Bu işlem SDK Manager ile yapılabilir.

Home API'leri test etmek için gerekenler:

  • Geliştirme için kullanmak istediğiniz Google Hesabı ile ayarlanmış, Android 10 veya sonraki sürümleri çalıştıran bir Android cihaz. Android Studio uygulamasının güncel bir sürümünün yüklü olduğundan ve bu geliştirme hesabıyla oturum açıldığından emin olun.
  • Kablosuz ağ.
  • Matter cihazlarına erişmek ve bunları kontrol etmek için Home API'leri destekleyen bir Google hub'ına da ihtiyacınız vardır. Ayrıntılar için Android'de bağlantı başlıklı makaleyi inceleyin.
  • Evde en az bir desteklenen cihaz bulunmalıdır. Bu cihaz (veya test etmek istediğiniz başka bir cihaz) Thread kullanıyorsa hub da Thread Border Router (TBR) olmalıdır. Aşağıdaki cihaz türleri ve özellikleri, Android örnek uygulaması tarafından desteklenir:

    • Renk sıcaklığı ışığı (açma ve kapatma, parlaklık)
    • Temas Sensörü (boole durumu)
    • Kısılabilir Işık (açma ve kapatma, parlaklık)
    • Kapı Kilidi
    • Genişletilmiş Renkli Işık (açma ve kapatma, parlaklık)
    • Genel Anahtar
    • Google Sınır Yönlendirici
    • Google Kamera
    • Google Doorbell
    • Doluluk Sensörü (doluluk algılama)
    • Açma/Kapama Işığı (açma ve kapama, parlaklık)
    • Açma/Kapatma Işık Anahtarı
    • Açma/Kapatma Fişli Birimi (açık ve kapalı)
    • Açma/Kapama Sensörü

Desteklenen merkezler

Yalnızca belirli Google Nest hub'ları Home API'lerini destekler.

Tablo: Home API'leri destekleyen Google Nest Hub'lar
Cihaz Thread sınır yönlendirici desteği Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

SDK'yı ayarlama

Bu açık beta sürümündeki Home API'ler, Geliştiriciler İçin Google tarafından geliştirme için sağlanan standart kitaplıklara henüz dahil edilmemiştir. Home API'lerle uygulama geliştirmek için kitaplıkları indirip yerel olarak barındırmanız gerekir.

Home API'leri Android SDK'sını indirmek için öncelikle Google Home Developers'da oturum açmanız gerekir.

Hemen oturum açın.