Home API'lerini bir Android uygulamasına eklemek için birkaç ön koşulu karşılamanız gerekir.
Ön koşullar
Geliştirme için bilgisayarınızda aşağıdaki araçların yüklü olması gerekir:
Android Studio, 2024.2.1 ("Ladybug") veya sonraki sürümler. Bu sürümden önceki sürümlerin Home API'leri SDK'sıyla düzgün çalışmayabileceğini unutmayın.
Android hata ayıklayıcısı (
adb).adbuygulamasını yükleyin.Bu işlem SDK Yöneticisi ile yapılabilir.
Ayrıca, Home API'lerini test etmek için şunlara ihtiyacınız vardır:
- Geliştirme için kullanmayı planladığınız bir Google Hesabı ile kurulmuş, Android 10 veya sonraki bir sürümü çalıştıran bir Android cihaz. Android Studio'nın güncel bir sürümünün yüklendiğinden ve bu geliştirici hesabıyla oturum açıldığından emin olun.
- Kablosuz ağ
- Matter cihazlara erişmek ve bunları kontrol etmek için Home API'lerini destekleyen bir Google hub'ı da gerekir. Ayrıntılar için Android'de bağlantı başlıklı makaleyi inceleyin.
Evde desteklenen en az bir cihaz olmalıdır. Bu cihaz (veya test etmek istediğiniz başka bir cihaz) Thread kullanıyorsa hub da Thread sınır yönlendirici olmalıdır. Android örnek uygulamasında aşağıdaki cihaz türleri ve özellikleri desteklenir:
- Renk sıcaklığı ışığı (açma/kapama, parlaklık)
- Temas sensörü (boolean durumu)
- Kısılabilir Işık (açma/kapama, parlaklık)
- Genişletilmiş Renkli Işık (açma/kapama, parlaklık)
- Genel Anahtar
- Google Kamera
- Varlık sensörü (evde birisinin olup olmadığını algılama)
- Işığı açma/kapatma (açma ve kapatma, parlaklık)
- Açma/Kapatma Işık Anahtarı
- Açma/Kapatma Fiş Ünitesi (açık ve kapalı)
- Açık/Kapalı Sensörü
Desteklenen merkezler
Yalnızca belirli Google Nest hub'ları Home API'lerini destekler.
SDK'yı ayarlama
Bu açık beta sürümündeki Home API'leri, Google'ın geliştirme için sağladığı standart kitaplıklara henüz dahil edilmemiştir. Home API'leri ile uygulama geliştirebilmek için kütüphaneleri yerel olarak indirmeniz ve barındırmanız gerekmektedir.
Home APIs Android SDK'sını indirmek için öncelikle Google Home Developers'da oturum açmanız gerekir.