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

2025-04-09

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

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: 25.09.33
  • Google hub donanım yazılımının minimum sürümleri:
    • Cast: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home uygulaması: Tüm sürümlerle çalışır
  • androidx.core kitaplığı: 1.10.0
  • Matter sürümü: 1.4.0.0
1. Bu derleme şu anda üretime sunulma aşamasındadır ve 22 Nisan 2025'e kadar tüm cihazlarda kullanılabilir olacaktır.

Yeni özellikler

  • Home Graph'ten nesne yükleme performansı iyileştirildi.
  • Automation API
    • Otomasyonların, otomasyonda belirtilen ölçütlere göre cihazları dinamik olarak seçmesine olanak tanıyan �� varlık filtreleri için destek eklendi.
  • Device API

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.

Bilinen sorunlar düzeltildi

  • Discovery API, ilklendirmeden önce veya ilklendirme tamamlanmadan önce çağrılırsa code 14: UNKNOWN ile bir HomeException ve "Yol bulunamadı." mesajı oluşturulur.
  • 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.

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_1_2_0_RC06
  • 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 bazı bitmap alanları için BitmapConstraint döndürmesi gerekirken 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, ilklendirmeden önce veya ilklendirme tamamlanmadan önce çağrılırsa code 14: UNKNOWN ile bir HomeException ve "Yol bulunamadı." mesajı oluşturulur.
    • Geçici çö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ü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.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:
  • Batching API (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ı 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.