Home API'leri Android SDK'sı sürüm notları

2025-03-14

  Home APIs Public Beta sürümü 1.2.0  

Bu sürümde hata düzeltmeleri yer almakta ve Home APIs Android SDK'sının genel kullanıma sunma (GA) kalitesi geliştirilmektedir.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 25.06.32
  • Google hub donanım yazılımının minimum sürümleri:
    • Cast sürümü: 3.75.456944
    • Fuchsia minimum sürümü: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_202412_EAP_1_2_RC01
  • Google Home uygulamasının minimum sürümü: Tüm sürümlerle çalışır
  • androidx.core kitaplığının minimum sürümü: 1.10.0
  • Matter sürümü: 1.3.0.0
    • Not: Geçici Matter cihaz türleri ve kümeleri desteklenmez.

Yeni özellikler

  • Automation API:
    • Otomasyon koşullarında tarih aralıkları ve kısmi tarihler için destek. Aralıklarla tarih kullanma başlıklı makaleyi inceleyin.
    • Discovery API, önceki sürümlerde BitmapConstraint döndürmesi gereken bazı bitmap alanları için NumberSetConstraint döndürüyordu. Bu alanlar artık beklendiği gibi BitmapConstraint döndürüyor. Bu, LevelControl özellik komutlarındaki optionsMask ve optionsOverride bitmap'leriyle sınırlıdır.

Bilinen sorunlar

  • Kablosuz ağdan mobil ağa geçiş yaparken cihaz denetimi gecikmesi artabilir.
  • Bir merkez fabrika ayarlarına sıfırlandıktan sonra cihazlar çevrimdışı görünebilir.
  • Discovery API, başlatmadan önce veya başlatma tamamlanmadan önce çağrılırsa code 14: UNKNOWN içeren bir HomeException ve "Yol bulunamadı." mesajı oluşturulur.
    • Çözüm: Discovery API'yi yalnızca otomasyon adaylarına gerçekten ihtiyaç duyduğunuzda çağırın. Aday öğeleri önceden getirmeyin ve önbelleğe almayın. Discovery API yöntemlerini çağırmadan önce bir öğenin internete bağlı olup olmadığını kontrol edin.
  • Birden fazla yapı ve birden fazla kullanıcı içeren bir ortamda, yapılar ve kullanıcılar arasında geçiş yapmak cihazların iade edilmemesine neden olabilir.

Bilinen sorunlar düzeltildi

  • Bir Home APIs uygulaması, başlatıldıktan sonra HomeManager.structures() çağrısını ilk kez yaptığında, bir veya daha fazla yapı mevcut olsa bile sıfır yapı alır. Bu durum, Google Hesabı ile ilişkili yapı bulunmadığına dair yanlış bir izlenim verir.
  • Kullanıcılar otomasyonları yüklerken, oluştururken ve düzenlerken uzun bekleme süreleri yaşayabilir.
  • Kurulum akışını Kamera uygulamasından başlatan kullanıcılar, Matter devreye alma işlemini tamamlamak için QR kodunu iki kez taramalıdır.
  • 200'den fazla cihaz içeren bir yapıda Discovery API, hiçbir aday döndürmeyebilir.

2025-01-29

  Home APIs Herkese Açık Beta sürümü 1.1.0  

Bu sürüm, hata düzeltmeleri içerir ve Home APIs Android SDK'sının genel kullanıma sunma (GA) kalitesini iyileştirir.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 25.02.32
  • Google hub donanım yazılımının minimum sürümleri:
    • Cast sürümü: 3.75.456944
    • Fuchsia minimum sürümü: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • Google Home uygulamasının minimum sürümü: Tüm sürümlerle çalışır
  • androidx.core kitaplığının minimum sürümü: 1.10.0
  • Matter sürümü: 1.3.0.0
    • Not: Geçici Matter cihaz türleri ve kümeleri desteklenmez.

Yeni özellikler

  • Streaming API:
  • Gruplandırma API'si (Deneysel):

Bilinen sorunlar

  • Kullanıcılar otomasyonları yüklerken, oluştururken ve düzenlerken uzun bekleme süreleri yaşayabilir.
  • Kurulum akışını Kamera uygulamasından başlatan kullanıcılar, Matter devreye alma işlemini tamamlamak için QR kodunu iki kez taramalıdır.
  • 200'den fazla cihaz içeren bir yapıda Discovery API, hiçbir aday döndürmeyebilir.

Bilinen sorunlar düzeltildi

  • Oturum açmış Google Hesabı'nın değiştirilmesi başarısız olabilir ve hata oluşabilir.
  • Google TV cihazları, MediaPlayback özelliğini kullanan otomasyonlarda çalışmayabilir.
  • Yalnızca bir Google merkezi içeren bir yapıda:
    • Matter cihazları Google Home uygulamasında çevrimdışı görünebilir.
    • Google Asistan, Matter cihazları kontrol edemez.
    • Akıllı ekranlar, Matter cihazları kontrol edemez veya Matter cihazlarının durumunu görüntüleyemez.
  • Bazı cihazlarda uygulama her zaman doğru durumu yansıtmayabilir ve uygulamanız, Google Home uygulaması gibi bir Google uygulaması tarafından raporlanandan farklı bir durum bildirebilir. Bunun nedeni genellikle cihazların durumu Google'a bildirmemesidir.
    • Geçici çözüm: Bir Google uygulamasıyla durumu kontrol etmek uyuşmazlığı çözer.

2025-01-14

Home API'lerinin başlatılmasıyla ilgili yönergeler güncellendi.

Home örneğinin bağlam tekil nesnesi olarak başlatılması gerektiğini daha net bir şekilde belirttik. Bu sayede uygulamanızda daha sorunsuz bir kullanıcı deneyimi sağlanır ve geçersiz oturumlarla ilgili hatalar önlenir.

2025-01-07

  Home APIs Herkese Açık Beta sürümü  

Herkese açık geliştirici beta sürümünde tüm geliştiriciler uygulamalarını oluşturmaya ve test etmeye başlayabilir.

Bu sürümde hata düzeltmeleri yer alıyor ve Home APIs Android SDK'sı için genel kullanıma sunma (GA) kalitesi iyileştiriliyor. Google Nest Audio ve Google TV cihazları için daha iyi destek de bu iyileştirmeler arasında yer alıyor.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 24.45.34
  • Google hub donanım yazılımının minimum sürümleri:
    • Cast sürümü: 3.74.444798
    • Fuchsia minimum sürümü: 22.20240805.103.161
  • Android SDK'sı: home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home uygulaması (GHA) minimum sürümü: tüm sürümlerle çalışır
  • androidx.core kitaplığının minimum sürümü: 1.10.0
  • Matter sürümü: 1.3.0.0
    • Not: Geçici Matter cihaz türleri ve kümeleri desteklenmez.

Bilinen sorunlar

  • Oturum açmış Google Hesabı'nın değiştirilmesi başarısız olabilir ve hata oluşabilir.
    • Çözüm: İzin akışını yeniden çalıştırın veya uygulamayı yeniden başlatın.
  • Google TV cihazları, MediaPlayback özelliğini kullanan otomasyonlarda çalışmayabilir.
  • Yalnızca bir Google merkezi içeren bir yapıda:
    • Matter cihazları Google Home uygulamasında (GHA) çevrimdışı görünebilir.
    • Google Asistan, Matter cihazlarını kontrol edemez.
    • Akıllı ekranlar, Matter cihazları kontrol edemez veya Matter cihazlarının durumunu görüntüleyemez.
  • Bazı cihazlarda uygulama her zaman doğru durumu yansıtmayabilir ve uygulamanız, Google Home uygulaması (GHA) gibi bir Google uygulaması tarafından raporlanandan farklı bir durum bildirebilir. Bu durum genellikle cihazların durumu Google'a bildirmemesinden kaynaklanır.
    • Geçici çözüm: Bir Google uygulamasıyla durumu kontrol etmek uyuşmazlığı çözer.

Bilinen sorunlar düzeltildi

  • Uygulama, işlem sırasında simge durumuna küçültülürse devreye alma işlemi başarısız olabilir.
  • Sunucu tarafında yaşanan bir sorun, OkGoogle başlatıcılarının otomasyonlarda çalışmasını engelleyebilir.
  • Fuchsia işletim sistemini kullanan ve yapıda Matter cihazı bulunmayan bir hub kullanılırken hub 3 saatten uzun süre boşta bırakılırsa ilk Matter cihazının devreye alınması, Matter cihazının çevrimdışı olmasına neden olur.
  • Bir hub için fabrika verilerine sıfırlama işlemi yapıldıktan sonra, yeni devreye alınan cihazlara gönderilen komutlar, cihazın çevrimiçi olarak bildirilmesine rağmen başarısız olabilir.