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 Eklenti Birimi (açık ve kapalı)
- Açma/Kapatma 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'lerini kullanarak 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.