Arka planda ses güvenliğini artırma

Android 17'den itibaren ses çerçevesi, bu değişikliklerin kullanıcı tarafından kasıtlı olarak başlatılmasını sağlamak için ses çalma, ses odağı istekleri ve ses seviyesi değişikliği API'leri dahil olmak üzere arka plandaki ses etkileşimleriyle ilgili kısıtlamaları zorunlu kılar.

Android 17'de çalışan ve bu arka plan ses etkileşimlerine sahip tüm uygulamaların görünür bir etkinliği olmalı veya SHORT_SERVICE türünde olmayan bir ön plan hizmeti çalıştırması gerekir. Bu, uygulamanın API düzeyi 37'yi hedefleyip hedeflemediğine bakılmaksızın geçerlidir.

Android 17'yi (API düzeyi 37) hedefleyen uygulamalar için ek bir kısıtlama vardır. Uygulama arka planda çalışıyorsa kullanım sırasında (WIU) özelliklerine sahip bir ön plan hizmeti çalıştırması gerekir. (Bir ön plan hizmeti, kullanıcı tarafından başlatılan bir işleme yanıt olarak veya uygulama kullanıcıya görünürken başlatılırsa WIU özellikleri verilir.) Ancak uygulamaya kesin zamanlı alarm izni verildiyse ve uygulama, USAGE_ALARM özelliğine sahip ses akışlarında değişiklik yapıyorsa WIU özellikleri şartı geçerli değildir.

Uygulama, geçerli bir yaşam döngüsünde değilken ses API'lerini çağırmaya çalışırsa ses çalma ve ses seviyesi değiştirme API'leri, istisna oluşturmadan veya hata mesajı vermeden sessizce başarısız olur. Ses odağı API'si, AUDIOFOCUS_REQUEST_FAILED sonuç koduyla başarısız oluyor.

Bu değişikliği neden yapıyoruz?

Bu kısıtlamaların getirilmesinin amacı, istenmeden arka planda sesle ilgili hatalı deneyimlerin yaşanmasını azaltmaktır. Buna örnek olarak aşağıdakiler verilebilir:

• Ön plan hizmeti olmadan ses çalan uygulamalar dondurulabilir. Uygulamanın dondurulması kaldırıldığında, ses oynatma beklenmedik bir şekilde devam eder. Bu durum, saatler sonra bile gerçekleşebilir.
• Ön plan hizmeti olmadan ses çalan uygulamalar, çeşitli çalıştırma kısıtlamalarıyla karşılaştı ve bu durum, ses performansının kesintili olmasına neden oldu.
• Oynatma, etkinlik yaşam döngüsünden ayrıldığında oynatma oturumunun veya odak etkinliklerinin sızmasına neden olabilir. Bu durumda, kullanıcı oynatmayı durduramaz.

Geliştiricilerin uygulamalarını test etmelerini ve kasıtlı ses kullanım alanlarından olumsuz etkilenenler varsa davranış değişikliğiyle ilgili geri bildirimde bulunmalarını öneririz. Lütfen bu Android 17 uygulama uyumluluğu sorun izleyicisini kullanarak sorunları bildirin.

Etkilenen arka plan sesi kullanım alanlarını belirleme

Ses çalma uygulamanızı denetleyin ve uygulamanızın koşullu durumlarda bile arka planda ses etkileşimi işlevi sağlamayı amaçlayıp amaçlamadığını belirleyin.

Uygulamanız yalnızca ses çalmak veya resim içinde resim (PiP) modu kullanmak da dahil olmak üzere kullanıcıya görünür bir etkinlik gösterirken ses API'lerinden yararlanmak istiyorsa bu değişikliklerden etkilenmez.

Uygulamanızda görüntülü görüşme uygulamaları da dahil olmak üzere VOIP işlevselliği sağlanıyorsa sesin başarılı bir şekilde kaydedilmesi için oynatma ile ilgili yeni şartları (genellikle önerilen telekom API'leri kullanılarak) karşılaması gerekir. Bu nedenle, uygulamanızın bu durumdan etkilenme olasılığı düşüktür.

Uygulamanız ekran kapalıyken veya etkinliğiniz görünür değilken ses çalmaya devam etmeyi amaçlıyorsa (bu durum en çok müzik akışı uygulamalarında veya podcast uygulamalarında görülür) uygulamanızın arka planda ses işlevi sağladığı kabul edilir ve yeni şartları karşılaması gerekir.

Etkilenmesi muhtemel arka plan ses senaryoları

Uygulamanız, açıkken başlatılan veya açık bir kullanıcı tetikleyicisine yanıt olarak başlatılan sesli etkileşimi devam ettirme modelini izlemiyorsa uygulamanızın işlevselliği sessizce devre dışı bırakılabilir.

Örneğin, uygulamanız BOOT_COMPLETE yanıtı olarak bir ön plan hizmeti başlatırsa ve sesle etkileşimde bulunmaya çalışırsa bu işlem engellenir.

Etkiyi azaltmak için en iyi arka plan sesi uygulamaları

• Arka planda ses çalmayı yönetmek için media3 Jetpack kitaplığının MediaSessionService bileşenini kullanın.

  Bu durumda, kitaplık oynatma yaşam döngüsünün yönetilmesine yardımcı olduğundan uygulamanızın arka planda sağlamlaştırmadan etkilenmesi olası değildir.

• Media3 kitaplığını kullanmıyorsanız mediaPlayback FGS'yi manuel olarak başlatmanız gerekir. Arka planda ses çalma olasılığı varsa uygulama ön plandayken her zaman ön plan hizmeti başlatın.

  Örneğin, uygulamanız normalde yalnızca ön planda çalışan ancak ekran kapalıyken oynatmaya devam etme özelliği içeren bir video akışı uygulamasıysa kullanıcı tarafından başlatılan oynatma tetikleyicisi gerçekleştiğinde uygulamanız yine de bir ön plan hizmeti başlatmalıdır.

  Bu işlem, ön plan hizmetinin WIU özellikleriyle başlatılmasını sağlar.

• 10 dakikadan kısa süren geçici arızalar sırasında mediaPlayback FGS'yi etkin tutun.

  Uygulamanızda geçici bir hata varsa (ör. ağ etkinliği nedeniyle arabelleğe alma ile ilgili bir sorun) veya geçici bir kesinti bekleniyorsa (ör. AUDIOFOCUS_LOSS_TRANSIENT), oynatma amacı devam etmelidir. Bu nedenle FGS'niz etkin kalmalıdır.

• Oynatma sonunda ön plan hizmetini durdurun ve oynatmayı yalnızca kullanıcı açıkça devam ettirirse yeniden başlatın.

  Oynatmayı sonlandırmak için kalıcı bir sinyal (ör. içerik tamamlandı, otomatik oynatma yok, AUDIOFOCUS_LOSS, UMO'dan gelen bir duraklatma etkinliği veya bir medya anahtarı etkinliği) ya da kurtarılamayan bir hata durumunda uygulamanız ses etkileşimini durdurmalı, ön plan hizmetini durdurmalı ve medya oturumunu sonlandırmalıdır. Tüm bunları yapmak, kullanıcının istediği arka plan ses etkileşimini "tamamlama" anlayışına karşılık gelir. Bu işlemi yaptıktan sonra uygulamanızın artık arka planda ses etkileşimi özellikleri olmaz.

  Ardından, kullanıcı oynatmayı açıkça devam ettirirse (ör. uygulamanızın kullanıcı arayüzü veya Universal Media Object oynatma düğmesi aracılığıyla) ses oynatmayı başlatma amacı geri döner ve yeni bir ön plan hizmeti başlatılır.

• Ses oynatma davranışını adb shell komutlarıyla test edin.

Değişiklikleri test etme

Aşağıdaki ADB komutunu çalıştırarak uygulamanızın uygunluğunu Android 17 veya sonraki sürümleri çalıştıran uygulamalarda (Beta 3'ten itibaren) test edebilirsiniz:

adb shell cmd audio set-enable-hardening <enable|disable|throw>

Bu komutun aşağıdaki seçenekleri vardır:

• enable: Tüm uygulamalar için tüm ses güvenliği kısıtlamalarını etkinleştirir. WIU ön plan hizmetleri şartı, uygulamanın Android 17'yi (API düzeyi 37) hedefleyip hedeflemediğine bakılmaksızın geçerlidir. Ayrıca, uygulama alarm akışlarında değişiklik yapıyor ve tam kesin zamanlı alarm iznine sahip olsa bile bu koşul uygulanır.

• disable: Tüm ses sağlamlaştırma kısıtlamalarını devre dışı bırakır.

• throw: enable gibi tüm uygulamalar için tüm ses sağlamlaştırma kısıtlamalarını etkinleştirir. Ayrıca bu işaret, ses ve odak etkileşimleri için IllegalStateException atarak yüksek hataları etkinleştirir. Ses oynatma için yazma yöntemi sürekli olarak bir hata kodu döndürüyor. Açıkça yazma işlemi yapılmayan oynatma modlarında uygulama kilitleniyor.

Uygulamada, ses güvenliğini zorunlu kılma nedeniyle sessiz hatalar oluşup oluşmadığını belirlemek için adb dumpsys audio veya logcat simgesini kullanın. Bu durumda, paket adınızla birlikte AudioHardening önekli bir giriş gösterilir. Mesaj level: full içeriyorsa uygulamanız bir ön plan hizmeti çalıştırıyor ancak hizmetin kullanım sırasında özelliği yok. İleti level: partial içeriyorsa uygulamanız hiç ön plan hizmeti çalıştırmıyor demektir.

Kullanım sırasında işlevselliği ile FGS'yi anlama

Genellikle, kullanıcı tarafından başlatılan işlemleri uzatmak için bir uygulama ön plandayken ön plan hizmetleri (FGS) başlatılmalıdır. Bazı özel durumlarda, uygulamaların arka planda çalışırken ön plan hizmeti başlatmasına izin verilir. Ancak bu ön plan hizmetlerine genellikle kullanım sırasında (WIU) özellikleri verilmez.

WIU, güvenlik kapısı görevi görür. Kullanıcının uygulamanın etkinliğinden haberdar olmayabileceği durumlarda, arka planda başlatılan ön plan hizmetlerinin belirli hassas davranışlarda bulunmasını engeller. Bu izin, uygulamanın konum, kamera veya mikrofon gibi hassas verilere erişmesini engeller. Ayrıca Android 17'den itibaren, genellikle görünür bir kullanıcı arayüzü bağlamı gerektiren ses API'lerini de engeller.

İşinize yarayabilecek bir referans:

• Standart ön plan hizmetleri: Uygulama görünürken veya arka plan etkinliği başlatma özelliği verilirken başlatılan hizmetlere WIU erişimi verilir.
• Arka planda başlatılan ön plan hizmetleri (BFSL): Çoğu, WIU erişimi vermez. WIU'nun verildiği temel istisnalar, açık kullanıcı niyeti içeren etkileşimlerdir. Örneğin, bildirim tıklamaları, widget etkileşimleri veya harici bir cihazdan gelen medya tuşu etkinlikleri.
• Sistem tarafından başlatılan ÖPH: Ön plan hizmetleri, sistem sunucusu temsilcisi tarafından (ör. Telecom Jetpack kitaplığından) veya özel işlevler gerçekleştirmek için yükseltilmiş bir ön plan durumunu temsil eden sistem bağlamaları tarafından başlatılırsa (ör. VoiceInteractionService için) WIU erişimi verilir.

Daha fazla bilgiyi Arka plandan ön plan hizmeti başlatmayla ilgili kısıtlamalar başlıklı makalede bulabilirsiniz.

Etkilenen ses API'lerinin tam listesi