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

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

• Device API
  • Çok kaynaklı bir cihazı devre dışı bırakma denemesi için yeni bir DecommissionIneligibleReason tanımlanır. Çok kaynaklı cihazlar bölümüne bakın.

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

• Automation API
  • Otomasyonlar, sınırlı sayıda çalışacak şekilde kısıtlanabilir. Yürütme sayısını sınırlama başlıklı makaleye bakın.

• Device API
  • Matter cihazlarını programatik olarak kaldırma özelliği. Cihazları kaldırma başlıklı makaleyi inceleyin.
  • Aşağıdaki kullanımdan kaldırılan HomeDevice üyeleri kaldırıldı:
    1. HomeDevice.trait(). Android için cihazlara ve cihaz meta verilerine erişme başlıklı makaleyi inceleyin.
    2. HomeDevice.isInRoom. Bunun yerine HomeDevice.roomId kullanın.
    3. HomeDevice.isInStructure. Bunun yerine HomeDevice.structureId kullanın.
• 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 güncellenen SDK yapıları.

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

• Matter Switch cihazları tarafından oluşturulan etkinliklerin işlenmesini basitleştiren ve anahtarların otomasyon başlatıcılarını tetiklemesine olanak tanıyan SyntheticSwitch özelliğini kullanıma sunar.
• ExtendedDoorLock özelliğinde önemli bir değişiklik yapıldı: user_id alanının veri türü String olarak değiştirildi.Long Bkz.
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

  Bu özelliği kullanan uygulamaların yeniden derlenmesi gerekir.

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

• Google Home uygulamasında (GHA) ev konumu ayarlanmamışsa otomasyon oluşturulurken Google Home uygulaması FailedPreconditionException hatasıyla 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
  • Cihazları yeniden adlandırma özelliği eklendi. Cihaz adını değiştirme başlıklı makaleyi inceleyin.
• Structure API
  • Odaları yeniden adlandırma özelliği eklendi. Oda adını değiştirme başlıklı makaleyi inceleyin.

Bilinen sorunlar

Google Home uygulamasında (GHA) ev konumu ayarlanmamışsa Google Home uygulaması, otomasyon oluşturulurken FailedPreconditionException simgesiyle birlikte 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.1900601¹
• 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 sunulmaktadır ve 22 Nisan 2025'e kadar tüm cihazlarda kullanılabilecektir.}

Yeni özellikler

• Home Graph'ten nesneler yüklenirken 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
  • Buluttan buluta cihaz bilgileri artık BasicInformationTrait uygulamasında kullanılabilir.

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:
  • Otomasyon koşullarında tarih aralıkları ve kısmi tarihler için destek. Tarihleri kullanma başlıklı makalenin arasında bölümünü inceleyin.
  • Önceki sürümlerde Discovery API, BitmapConstraint döndürmesi gerekirken bazı bit eşlem alanları için NumberSetConstraint döndürüyordu. Bu alanlar artık beklendiği gibi BitmapConstraint değerini döndürüyor. Bu, LevelControl özellik komutlarındaki optionsMask ve optionsOverride bit eşlemleriyle sınırlıdır.

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 otomasyon adaylarına gerçekten 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:
  • Eklenen, değiştirilen ve kaldırılan yapılar, odalar ve cihazlar hakkında bildirim gönderen etkinlik akışları sağlar.
  • Varlık ilişkisi etkinliklerine abone olma başlıklı makaleyi inceleyin.
• Batching API (Deneysel):
  • Geliştiricinin, aynı anda yürütülen gruplar halinde birden fazla komut göndermesine olanak tanır.
  • Aynı anda birden fazla komut gönderme başlıklı makaleyi inceleyin.

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.
  • Geçici çözüm: Uygulamanızda Commissioning API kullanılırken yarım sayfa bildirimlerini bastırmak için suppressHalfSheetNotification() API'yi kullanın.
• 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.