Плавная потоковая передача
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
ExoPlayer поддерживает SmoothStreaming с форматом контейнера FMP4. Медиапотоки должны быть демультиплексированы, то есть видео, аудио и текст должны быть определены в отдельных элементах StreamIndex в манифесте SmoothStreaming. Также должны поддерживаться содержащиеся в них форматы аудио- и видеоматериалов (подробнее см. в разделе «Форматы материалов» ).
Особенность | Поддерживается | Комментарии |
---|
Контейнеры | | |
ФМП4 | ДА | Только демультиплексированные потоки |
Скрытые субтитры | | |
ТТМЛ | ДА | Встроено в FMP4 |
Защита контента | | |
PlayReady SL2000 | ДА | только Android TV |
Живое воспроизведение | | |
Регулярное живое воспроизведение | ДА | |
Общие данные клиента медиа (CMCD) | ДА | Руководство по интеграции |
Для воспроизведения потока SmoothStreaming вам необходимо использовать модуль SmoothStreaming.
Котлин
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.8.0")
Круто
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.8.0"
Затем вы можете создать MediaItem
для URI манифеста SmoothStreaming и передать его проигрывателю.
Котлин
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(ssUri))
// Prepare the player.
player.prepare()
Ява
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(ssUri));
// Prepare the player.
player.prepare();
Если ваш URI не заканчивается на .ism/Manifest
, вы можете передать MimeTypes.APPLICATION_SS
в setMimeType
MediaItem.Builder
, чтобы явно указать тип содержимого.
ExoPlayer будет автоматически адаптироваться между представлениями, определенными в манифесте, учитывая как доступную пропускную способность, так и возможности устройства.
Для дополнительных возможностей настройки вы можете создать SsMediaSource
и передать его непосредственно проигрывателю вместо MediaItem
.
Котлин
// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a SmoothStreaming media source pointing to a manifest uri.
val mediaSource: MediaSource =
SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()
Ява
// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a SmoothStreaming media source pointing to a manifest uri.
MediaSource mediaSource =
new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();
Доступ к манифесту
Вы можете получить текущий манифест, вызвав Player.getCurrentManifest
. Для SmoothStreaming необходимо привести возвращаемый объект к SsManifest
. Обратный вызов onTimelineChanged
метода Player.Listener
также вызывается при каждой загрузке манифеста. Это происходит один раз для контента по запросу и, возможно, несколько раз для контента в режиме реального времени. Следующий фрагмент кода показывает, как приложение может выполнять какие-либо действия при каждой загрузке манифеста.
Котлин
player.addListener(
object : Player.Listener {
override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
val manifest = player.currentManifest
if (manifest is SsManifest) {
// Do something with the manifest.
}
}
}
)
Ява
player.addListener(
new Player.Listener() {
@Override
public void onTimelineChanged(
Timeline timeline, @Player.TimelineChangeReason int reason) {
Object manifest = player.getCurrentManifest();
if (manifest != null) {
SsManifest ssManifest = (SsManifest) manifest;
// Do something with the manifest.
}
}
});
Настройка воспроизведения
ExoPlayer предоставляет множество способов настроить воспроизведение в соответствии с потребностями вашего приложения. Примеры см. на странице настроек .
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-27 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-27 UTC."],[],[],null,["# SmoothStreaming\n\nExoPlayer supports SmoothStreaming with the FMP4 container format. Media streams\nmust be demuxed, meaning that video, audio, and text must be defined in distinct\nStreamIndex elements in the SmoothStreaming manifest. The contained audio and\nvideo sample formats must also be supported (see the\n[sample formats](/media/media3/exoplayer/supported-formats#sample-formats) section for details).\n\n| Feature | Supported | Comments |\n|-------------------------------------|-----------|---------------------------------------------------------|\n| **Containers** | | |\n| FMP4 | YES | Demuxed streams only |\n| **Closed captions/subtitles** | | |\n| TTML | YES | Embedded in FMP4 |\n| **Content protection** | | |\n| PlayReady SL2000 | YES | Android TV only |\n| **Live playback** | | |\n| Regular live playback | YES | |\n| **Common Media Client Data (CMCD)** | YES | [Integration Guide](/guide/topics/media/exoplayer/cmcd) |\n\nUsing MediaItem\n---------------\n\nTo play a SmoothStreaming stream, you need to depend on the SmoothStreaming\nmodule. \n\n### Kotlin\n\n```kotlin\nimplementation(\"androidx.media3:media3-exoplayer-smoothstreaming:1.8.0\")\n```\n\n### Groovy\n\n```groovy\nimplementation \"androidx.media3:media3-exoplayer-smoothstreaming:1.8.0\"\n```\n\nYou can then create a `MediaItem` for a SmoothStreaming manifest URI and pass it\nto the player. \n\n### Kotlin\n\n```kotlin\n// Create a player instance.\nval player = ExoPlayer.Builder(context).build()\n// Set the media item to be played.\nplayer.setMediaItem(MediaItem.fromUri(ssUri))\n// Prepare the player.\nplayer.prepare()\n```\n\n### Java\n\n```java\n// Create a player instance.\nExoPlayer player = new ExoPlayer.Builder(context).build();\n// Set the media item to be played.\nplayer.setMediaItem(MediaItem.fromUri(ssUri));\n// Prepare the player.\nplayer.prepare();\n```\n\n\u003cbr /\u003e\n\nIf your URI doesn't end with `.ism/Manifest`, you can pass\n`MimeTypes.APPLICATION_SS` to `setMimeType` of `MediaItem.Builder` to explicitly\nindicate the type of the content.\n\nExoPlayer will automatically adapt between representations defined in the\nmanifest, taking into account both available bandwidth and device capabilities.\n\nUsing SsMediaSource\n-------------------\n\nFor more customization options, you can create a `SsMediaSource` and pass it\ndirectly to the player instead of a `MediaItem`. \n\n### Kotlin\n\n```kotlin\n// Create a data source factory.\nval dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()\n// Create a SmoothStreaming media source pointing to a manifest uri.\nval mediaSource: MediaSource =\n SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri))\n// Create a player instance.\nval player = ExoPlayer.Builder(context).build()\n// Set the media source to be played.\nplayer.setMediaSource(mediaSource)\n// Prepare the player.\nplayer.prepare()\n```\n\n### Java\n\n```java\n// Create a data source factory.\nDataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();\n// Create a SmoothStreaming media source pointing to a manifest uri.\nMediaSource mediaSource =\n new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri));\n// Create a player instance.\nExoPlayer player = new ExoPlayer.Builder(context).build();\n// Set the media source to be played.\nplayer.setMediaSource(mediaSource);\n// Prepare the player.\nplayer.prepare();\n```\n\n\u003cbr /\u003e\n\nAccessing the manifest\n----------------------\n\nYou can retrieve the current manifest by calling `Player.getCurrentManifest`.\nFor SmoothStreaming, you should cast the returned object to `SsManifest`. The\n`onTimelineChanged` callback of `Player.Listener` is also called whenever\nthe manifest is loaded. This will happen once for on-demand content and\npossibly many times for live content. The following code snippet shows how an app\ncan do something whenever the manifest is loaded. \n\n### Kotlin\n\n```kotlin\nplayer.addListener(\n object : Player.Listener {\n override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {\n val manifest = player.currentManifest\n if (manifest is SsManifest) {\n // Do something with the manifest.\n }\n }\n }\n)\n```\n\n### Java\n\n```java\nplayer.addListener(\n new Player.Listener() {\n @Override\n public void onTimelineChanged(\n Timeline timeline, @Player.TimelineChangeReason int reason) {\n Object manifest = player.getCurrentManifest();\n if (manifest != null) {\n SsManifest ssManifest = (SsManifest) manifest;\n // Do something with the manifest.\n }\n }\n });\n```\n\n\u003cbr /\u003e\n\nCustomizing playback\n--------------------\n\nExoPlayer provides multiple ways for you to tailor playback experience to your\napp's needs. See the [Customization page](/guide/topics/media/exoplayer/customization) for examples."]]