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

2025-05-12

  Home APIs Public Beta sürümü 1.3  

Bu sürümde hata düzeltmeleri yer alıyor ve Home APIs Android SDK'sının beta kalitesi geliştiriliyor.

Minimum sürümler

  • Google Play Hizmetleri: 25.16.33
  • Google hub donanım yazılımının minimum sürümleri:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home uygulaması: Tüm sürümlerle çalışır
  • androidx.core kitaplığı: Tüm sürümlerle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

Bilinen sorunlar

Google Home uygulamasında (GHA) ev konumu ayarlanmamışsa otomasyon oluştururken Google Home uygulaması FailedPreconditionException hatasıyla kilitleniyor (Bunu nasıl yapacağınızla ilgili bilgi için Google Home adresini değiştirme bölümüne bakın).

  • Geçici çözüm: Otomasyon oluşturmaya çalışmadan önce Discovery API'yi kullanarak ev adresinin mevcut olup olmadığını kontrol edin.

Bilinen sorunlar düzeltildi

  • 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.

2025-04-09

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

Bu sürümde hata düzeltmeleri yer alıyor ve Home APIs Android SDK'sının beta kalitesi geliştiriliyor.

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 içeren 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 alıyor ve Home APIs Android SDK'sının beta kalitesi geliştiriliyor.

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 içeren 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şkilendirilmiş 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 alıyor ve Home APIs Android SDK'sının beta kalitesi geliştiriliyor.

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 Hub içeren bir yapıda:
    • Matter cihazları Google Home uygulamasında ç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ı 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 tekilliği 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 beta kalitesi geliş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.