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ı (
adb
).adb
uygulaması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:
- Android 10 veya sonraki bir sürümü çalıştıran ve geliştirme için kullanmayı planladığınız bir Google Hesabı ile kurulmuş bir Android cihaz. Android Studio uygulaması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 bu cihazları 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. Aşağıdaki cihaz türleri ve özellikleri Android örnek uygulaması tarafından 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
- 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 Eklenti Birimi (açık ve kapalı)
- Açma/Kapatma Sensörü
Desteklenen hub'lar
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ştirmek için kitaplıkları indirip yerel olarak barındırmanız gerekir.
Home API'leri Android SDK'sını indirmek için önce Google Home Developers'a giriş yapmanız gerekir.