Ne Çalıyor? kartını görüntüleme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Ses çalan TV uygulamaları, kullanıcı ana ekrana döndükten veya
başka bir uygulamaya geçer. Bunu yapmak için uygulamanın evde bir Ne Çalıyor? kartı sağlaması gerekir
tıklayın. Bu kart, kullanıcıların sesin nereden geldiğini anlayıp uygulamanıza geri dönüp
medya oynatmayı denetleyin.
Etkin bir
MediaSession
Android çerçevesi ana ekranda bir Ne Çalıyor? kartı görüntüler. Kart
Albüm kapağı, başlık ve uygulama simgesi gibi medya meta verilerini içerir. Kullanıcı kartı seçtiğinde
Sistem uygulamayı açar.
Ne Çalıyor? kartı
Bir medya oturumu uyguladıktan sonra
oturumu etkinleştirir ve ses odağı isteğinde bulunursanız Ne Çalıyor? kartı görünür.
Not: Ne Çalıyor? kartı yalnızca medya için görüntülenir
ile
FLAG_HANDLES_TRANSPORT_CONTROLS
bayrak ayarlı. Bu işaret, API düzeyi 26'da kullanımdan kaldırılmıştır. Bununla birlikte, eski cihazlarda geriye dönük uyumluluk için bu işaret gerekebilir.
Bir
setActive(false).
çağrısı, medya oturumunu devre dışı bırakır veya başka bir uygulama medya oynatmayı başlattığında. Oynatmanın durumu:
tamamen durduruldu ve etkin medya yoksa, medya oturumunu devre dışı bırakın
hemen teslim edebilirsiniz. Oynatma duraklatıldıysa medya oturumunu bir gecikmenin ardından devre dışı bırakın
5-30 dakika arasında değişir.
Kartı güncelleyin
Uygulamanız MediaSession içindeki oynatma durumunu güncellediğinde
Ne Çalıyor? kartı, mevcut medyanın durumunu gösterecek şekilde güncellenir. Bunu nasıl yapacağınızı öğrenmek için
Oynatma durumunu güncelleyin.
Benzer şekilde, uygulamanız
Sağlanacak MediaMetadata
Şimdi Oynatılıyor kartına başlık, alt başlık gibi geçerli medya hakkında bilgi
ve çeşitli simgeleri kullanın. Bunu nasıl yapacağınızı öğrenmek için
Medya meta verilerini güncelleyin.
Kullanıcı işlemine yanıt verme
Kullanıcı Ne Çalıyor? kartını seçtiğinde sistem, dokümanın sahibi olan uygulamayı açar.
kabul edilir. Uygulamanız
PendingIntent -
setSessionActivity(),
sistem, belirttiğiniz etkinliği aşağıdaki kod snippet'inde gösterildiği gibi başlatır. Değilse
varsayılan sistem amacı açılır. Belirttiğiniz etkinlik, şu özelliklere sahip oynatma kontrolleri sağlamalıdır:
Kullanıcıların oynatmayı duraklatmasına veya durdurmasına olanak tanır.
Kotlin
val pi: PendingIntent = Intent(context, MyActivity::class.java).let { intent ->
PendingIntent.getActivity(
context, 99 /*request code*/,
intent,
PendingIntent.FLAG_UPDATE_CURRENT
)
}
session.setSessionActivity(pi)
Java
Intent intent = new Intent(context, MyActivity.class);
PendingIntent pi = PendingIntent.getActivity(context, 99 /*request code*/,
intent, PendingIntent.FLAG_UPDATE_CURRENT);
session.setSessionActivity(pi);
Kabul edilen kullanım alanları
Ne Çalıyor? kartı yalnızca kullanıcının sesin devam etmesini beklediği durumlarda kullanılmalıdır
arka planda oynatmaya devam edebilirsiniz. Bir oyundan gelen video oynatma veya ses her zaman
uygulamanız pencere içinde pencere özelliğiyle entegre olup uyumlu değilse duraklatılamaz.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Display a Now Playing card\n\nTV apps that play audio may continue to do so after the user returns to the home screen or\nswitches to another app. To do so, the app must provide a **Now Playing** card on the home\nscreen. This card lets users understand where the audio is coming from and return to your app to\ncontrol media playback.\n\n\nWhenever an active\n[MediaSession](/reference/android/media/session/MediaSession) is\npresent, the Android framework displays a **Now Playing** card on the home screen. The card\nincludes media metadata such as album art, title, and app icon. When the user selects the card,\nthe system opens the app.\n\nNow Playing card\n----------------\n\n\nAfter you [implement a media session](/training/tv/playback/media-session), set the\nsession to active, and request audio focus, the **Now Playing** card appears.\n\n**Note:** The **Now Playing** card displays only for a media\nsession with the\n[FLAG_HANDLES_TRANSPORT_CONTROLS](/reference/android/media/session/MediaSession#FLAG_HANDLES_TRANSPORT_CONTROLS)\nflag set. This flag is deprecated on API level 26. However, this flag could still be needed on older devices for backwards compatibility.\n\n\nThe card is removed from the launcher screen when a\n[setActive(false)](/reference/android/media/session/MediaSession#setActive(boolean))\ncall deactivates the media session or when another app initiates media playback. If playback is\ncompletely stopped and there is no active media, deactivate the media session\nimmediately. If playback is paused, deactivate the media session after a delay,\nusually from 5 to 30 minutes.\n\nUpdate the card\n---------------\n\n\nWhenever your app updates the playback state in the `MediaSession`, the\n**Now Playing** card updates to show the state of the current media. To learn how to do this, see\n[Update the playback state](/training/tv/playback/media-session#state).\n\n\nSimilarly, your app can update the\n[MediaMetadata](/reference/android/media/MediaMetadata) to provide\ninformation to the **Now Playing** card about the current media, such as the title, subtitle,\nand various icons. To learn how to do this, see\n[Update the media metadata](/training/tv/playback/media-session#metadata).\n\nRespond to user action\n----------------------\n\n\nWhen the user selects the **Now Playing** card, the system opens the app that owns the\nsession. If your app provides a\n[PendingIntent](/reference/android/app/PendingIntent) to\n[setSessionActivity()](/reference/android/media/session/MediaSession#setSessionActivity(android.app.PendingIntent)),\nthe system launches the activity you specify, as shown in the following code snippet. If not,\nthe default system intent opens. The activity you specify must provide playback controls that\nlet users pause or stop playback. \n\n### Kotlin\n\n```kotlin\nval pi: PendingIntent = Intent(context, MyActivity::class.java).let { intent -\u003e\n PendingIntent.getActivity(\n context, 99 /*request code*/,\n intent,\n PendingIntent.FLAG_UPDATE_CURRENT\n )\n}\nsession.setSessionActivity(pi)\n```\n\n### Java\n\n```java\nIntent intent = new Intent(context, MyActivity.class);\nPendingIntent pi = PendingIntent.getActivity(context, 99 /*request code*/,\n intent, PendingIntent.FLAG_UPDATE_CURRENT);\nsession.setSessionActivity(pi);\n```\n\nAccepted use cases\n------------------\n\n\nThe **Now Playing** card should only be used in cases where the user expects audio to continue\nplaying in the background when leaving your app. Video playback or sound from a game should always\npause, unless your app is integrating and compliant with picture-in-picture."]]
