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

2025-10-23

  Home API'leri herkese açık beta sürümü 1.5.1  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.41.30
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınla: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5_1
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.1.0

Yeni özellikler

  • Structure API
    • Hub Activation API, Google Home hub'ı programatik olarak keşfetmenizi ve etkinleştirmenizi sağlar. Android'de Hub etkinleştirme API'si başlıklı makaleyi inceleyin.
  • Android Örnek Uygulaması
    • Aşağıdaki kapı zili cihaz türleri için destek:
      • OnOff
      • Canlı yayın
      • İki yönlü konuşma
    • Hub Activation API: Hub'ları Etkinleştirme

Bilinen sorunlar düzeltildi.

  • Örnek uygulama, Cihaz görünümünde cihaz durumunu doğru şekilde göstermiyor.

2025-09-26

  Home API'leri herkese açık beta sürümü 1.5.0  

Bu sürümde kamera cihazları için destek sunuluyor, hata düzeltmeleri yapılıyor ve Home API'leri Android SDK'sının beta kalitesi artırılıyor.

Minimum sürümler

  • Google Play Hizmetleri: 25.37.31
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınla: 3.76.492738
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.1.0

Yeni özellikler

  • Automation API
    • Başlatıcılar, koşullar ve işlemler artık parametre olarak Matter yapılarını kabul ediyor.
  • Device API
    • Kamera cihaz türü eklendi. Aşağıdaki kamera özellikleri de Doorbell cihaz türünde kullanılabilir:
      • Kamera canlı yayını
      • Kamerada iki yönlü konuşma.
      • Kamerayla kaydı başlatma ve durdurma
  • Android Örnek Uygulaması
    • Kamera cihaz türü için destek:
      • Kamera canlı yayını
      • Kamerada iki yönlü konuşma.
      • Kamerayla kaydı başlatma ve durdurma
      • Kısıtlanmış cihaz türü izinleri.
    • Çoklu yöneticiyle devreye alma (devreye alınan cihazı paylaşma)
    • Önceden tanımlanmış OnOff otomasyon.

Bilinen sorunlar

  • Kablosuz ağdan mobil ağa geçiş yaparken cihaz kontrolünde gecikme yaşanabilir.
  • Buluttan buluta ile desteklenen Fan cihaz türlerinin kontrolü, örnek uygulamada çalışmayabilir.

Bilinen sorunlar düzeltildi.

  • Şu anda etkin olan hub zorla kaldırıldığında, beş dakikalık bir süre boyunca bazı cihazları kontrol etmek mümkün olmaz. Beş dakika sonra cihazları kontrol etme özelliği geri yüklenir.
  • Kullanıcı, hazır ayardan veya renk sıcaklığı seçiciden bir renk seçtikten sonra Extended Color Light, rengi güncelleyemiyor.

2025-09-08

Android için örnek uygulamanın 1.4.1 sürümü yayınlandı.

Yeni özellikler

  • Oda oluşturma, yeniden adlandırma, güncelleme ve silme
  • Üçüncü taraf Matter ağına ekleme

Düzeltilen bilinen sorunlar

  • İzin iptali sayfası bağlantısı artık çalışıyor.

2025-08-29

  Home API'leri herkese açık beta sürümü 1.4.1  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.33.32
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınla: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

Bilinen sorunlar

  • Şu anda etkin olan hub zorla kaldırıldığında, beş dakikalık bir süre boyunca bazı cihazları kontrol etmek mümkün olmaz. Beş dakika sonra cihazları kontrol etme özelliği geri yüklenir.

Bilinen sorunlar düzeltildi.

  • Android örnek uygulaması, bir kullanıcı termostatı desteklemediği bir moda ayarlamaya çalıştığında kilitleniyor.

2025-07-31

  Home API'leri herkese açık beta sürümü 1.4.0  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.28.34
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınla: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

  • Device API
  • Structure API
    • Home.hasPermissions() artık hem kullanıcının OAuth yetkilendirme durumunu (yapıya erişim) hem de uygulama izni verme işlemlerini içeriyor.
  • Android Örnek Uygulaması
    • Desteği sonlandırılan API çağrıları değiştirildi.
    • Cihazları yeniden adlandırma
    • Yalnızca Matter cihazlarını silin.

Bilinen sorunlar

  • Bir telefonda oturum kapatıp tekrar açtıktan sonra Home API'leri uygulaması cihazları kontrol edemez.
    • Geçici çözüm: Uygulamayı kapatın veya arka plana alın, ardından tekrar denemeden önce en az 10 saniye bekleyin.

Bilinen sorunlar düzeltildi.

  • Yuvasına yerleştirilmiş elektrik süpürgesi cihazları, "Yuvasına yerleştirildi" durumunu kaydetmez.

2025-07-08

Yayın yazılımı sürümü 3.76.479819 ile Nest Wifi Pro artık Home API'leri hub'ı olarak işlev görebilir.

2025-06-26

  Home API'leri herkese açık beta sürümü 1.3.2  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.23.31
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınlama:
      • Google Home, Google Home Mini ve Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Fuchsia: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

  • SDK yapısı iki ayrı yapıya bölünmüştür:
    • Home APIs SDK çerçevesi (play-services-home-17.0.0.aar)
    • SDK özellikleri ve cihaz türleri (play-services-home-types-17.0.0.aar)

    Bu sürümden itibaren geliştiricilerin, her iki yapıyı da projelerinin derleme zamanı ve çalışma zamanı kitaplık yollarına dahil etmesi gerekir.

Android Örnek Uygulaması

  • Kullanıcılar uygulamayla bağlantıyı kesebilir ve izinleri iptal edebilir.
  • play-services-home-17.0.0 ve play-services-home-types-17.0.0'yi içerecek şekilde SDK yapıları güncellendi.

Bilinen sorunlar

  • Yuvasına yerleştirilmiş elektrik süpürgesi cihazları, "Yuvasına yerleştirildi" durumunu kaydetmez.

2025-06-05

  Home API'leri herkese açık beta sürümü 1.3.1  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.19.32
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınlama: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

Özellikler

Android Örnek Uygulaması

Hata ayıklamayı kolaylaştırmak için yapıların, cihazların, türlerin, özelliklerin ve otomasyonların durumunu günlüğe kaydetme işlevleri eklendi.

Bilinen sorunlar

Android örnek uygulamasında, Otomasyon oluştur düğmesinin tetiklenmesi için bazen birden fazla dokunma gerekir.

Düzeltilen bilinen sorunlar

  • Ev konumu Google Home uygulamasında (GHA) ayarlanmamışsa otomasyon oluşturulurken Google Home uygulaması FailedPreconditionException ile kilitleniyor (Ev konumunu ayarlama hakkında bilgi için Google ev adresini değiştirme başlıklı makaleyi inceleyin).
  • Android örnek uygulamasında, connectivityState PARTIALLY_ONLINE olan bir cihaz daha önce kullanıcıya çevrimdışı olarak gösteriliyordu. Bu durum artık online olarak gösterilir.

2025-05-12

  Home API'leri herkese açık beta sürümü 1.3  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.16.33
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınlama: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core library: her sürümle çalışır
  • Matter sürümü: 1.4.0.0

Yeni özellikler

  • Automation API
    • Geliştiricilerin cron ifadelerini kullanarak saat, güneş saati ve takvime dayalı koşullara göre düzenli olarak çalışan otomasyonlar oluşturmasına olanak tanıyan düzenli planlanmış etkinlik başlatıcıları için destek eklendi.
  • Device API
  • Structure API

Bilinen sorunlar

Google Home uygulamasında (GHA) ev konumu ayarlanmamışsa otomasyon oluşturulurken Google Home uygulaması FailedPreconditionException hatasıyla kilitleniyor (Bunun nasıl yapılacağını öğrenmek için Google ev adresini değiştirme başlıklı makaleye bakın).

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

Düzeltilen bilinen sorunlar

  • Kablosuz ağdan mobil ağa geçiş yaparken cihaz kontrolünde gecikme yaşanabilir.
  • Bir hub fabrika ayarlarına sıfırlandıktan sonra cihazlar çevrimdışı görünebilir.

2025-04-09

  Home API'leri herkese açık beta sürümü 1.2.1  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri: 25.09.33
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Yayınlama: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home uygulaması: Her sürümle çalışır
  • androidx.core kitaplığı: 1.10.0
  • Matter sürümü: 1.4.0.0
1. Bu derleme şu anda üretimde kullanıma sunuluyor ve 22 Nisan 2025'e kadar tüm cihazlarda kullanılabilecek.

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 desteği eklendi.
  • Device API

Bilinen sorunlar

  • Kablosuz ağdan mobil ağa geçiş yaparken cihaz kontrolünde gecikme yaşanabilir.
  • Bir hub fabrika ayarlarına sıfırlandıktan sonra cihazlar çevrimdışı görünebilir.

Bilinen sorunlar düzeltildi.

  • Discovery API başlatılmadan önce veya başlatma işlemi tamamlanmadan önce çağrılırsa HomeException ile code 14: UNKNOWN ve "No route found." (Rota bulunamadı) mesajı gönderilir.
  • Birden fazla yapı ve birden fazla kullanıcı içeren bir ortamda, yapılar ve kullanıcılar arasında geçiş yapıldığında hiçbir cihaz döndürülmeyebilir.

2025-03-14

  Home API'leri herkese açık beta sürümü 1.2.0  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 25.06.32
  • Google Hub'ın minimum donanım yazılımı 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ü: Her sürümle çalışır
  • androidx.core library min version: 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:

Bilinen sorunlar

  • Kablosuz ağdan mobil ağa geçiş yaparken cihaz kontrolünde gecikme yaşanabilir.
  • Bir hub fabrika ayarlarına sıfırlandıktan sonra cihazlar çevrimdışı görünebilir.
  • Discovery API başlatılmadan önce veya başlatma işlemi tamamlanmadan önce çağrılırsa HomeException ile code 14: UNKNOWN ve "No route found." (Rota bulunamadı) mesajı gönderilir.
    • Geçici çözüm: Discovery API'yi yalnızca gerçekten otomasyon adaylarına ihtiyacınız olduğunda çağırın. Aday öğeleri önceden getirilip önbelleğe alınmaz. Discovery API yöntemlerini çağırmadan önce bir öğenin çevrimiçi 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ş yapıldığında hiçbir cihaz döndürülmeyebilir.

Bilinen sorunlar düzeltildi.

  • Bir Home API'leri uygulaması başlatıldıktan sonra ilk kez HomeManager.structures() çağrısı yaptığında, bir veya daha fazla yapı mevcut olsa bile sıfır yapı alır. Bu durum, Google Hesabı ile ilişkilendirilmiş yapı olmadığı gibi yanlış bir izlenim yaratır.
  • Kullanıcılar, otomasyonları yüklerken, oluştururken ve düzenlerken uzun bekleme süreleriyle karşılaşabilir.
  • Kurulum akışını Kamera uygulamasından başlatan kullanıcıların Matter devreye alma işlemini tamamlamak için QR kodunu iki kez taraması gerekir.
  • 200'den fazla cihaz içeren bir yapıda Discovery API, aday döndürmeyebilir.

2025-01-29

  Home API'leri herkese açık beta sürümü 1.1.0  

Bu sürümde hata düzeltmeleri yer almaktadır ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 25.02.32
  • Google Hub'ın minimum donanım yazılımı 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ü: Her sürümle çalışır
  • androidx.core library min version: 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üreleriyle karşılaşabilir.
  • Kurulum akışını Kamera uygulamasından başlatan kullanıcıların Matter devreye alma işlemini tamamlamak için QR kodunu iki kez taraması gerekir.
  • 200'den fazla cihaz içeren bir yapıda Discovery API, aday döndürmeyebilir.

Bilinen sorunlar düzeltildi.

  • Oturum açılan Google Hesabı'nı değiştirme işlemi başarısız olabilir ve hataya neden olabilir.
  • 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ını kontrol edemez veya herhangi bir Matter cihazının durumunu gösteremez.
  • Bazı cihazlarda bir uygulama her zaman doğru durumu yansıtmayabilir ve uygulamanız, Google Home uygulaması gibi bir Google uygulaması tarafından bildirilen durumdan farklı bir durum bildirebilir. Bu durum genellikle cihazların durumu Google'a bildirmemesinden kaynaklanır.
    • Geçici çözüm: Durumu bir Google uygulamasıyla kontrol etmek uyuşmazlığı giderir.

2025-01-14

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

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

2025-01-07

  Home API'leri herkese açık beta sürümü  

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

Bu sürümde hata düzeltmeleri yapılmış ve Home API'leri Android SDK'sının beta kalitesi artırılmıştır. Bu kapsamda, Google Nest Audio ve Google TV cihazları için destek iyileştirilmiştir.

Minimum sürümler

  • Google Play Hizmetleri minimum sürümü: 24.45.34
  • Google Hub'ın minimum donanım yazılımı sürümleri:
    • Cast sürümü: 3.74.444798
    • Fuchsia minimum sürümü: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home uygulaması (GHA) minimum sürümü: Her sürümle çalışır
  • androidx.core library min version: 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çılan Google Hesabı'nı değiştirme işlemi başarısız olabilir ve hataya neden olabilir.
    • Geçici çö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 hub'ı 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ını kontrol edemez veya herhangi bir Matter cihazının durumunu gösteremez.
  • Bazı cihazlarda uygulama her zaman doğru durumu yansıtmayabilir ve uygulamanız, Google Home uygulaması (GHA) gibi bir Google uygulaması tarafından bildirilen durumdan farklı bir durum bildirebilir. Bu durum genellikle cihazların durumu Google'a bildirmemesinden kaynaklanır.
    • Geçici çözüm: Durumu bir Google uygulamasıyla kontrol etmek uyuşmazlığı giderir.

Bilinen sorunlar düzeltildi.

  • İşlem sırasında uygulama simge durumuna küçültülürse devreye alma işlemi başarısız olabilir.
  • Sunucu tarafındaki bir sorun, OkGoogle ile başlatılan otomasyonların çalışmasını engelleyebilir.
  • Yapıda Matter cihazı olmayan ve Fuchsia çalıştıran bir hub kullanırken hub 3 saatten uzun süre boşta kalırsa ilk Matter cihazının devreye alınması, Matter cihazının çevrimdışı kalması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 çevrimiçi olarak bildirilmesine rağmen başarısız olabilir.