media
1.5.0-rc02
AndroidX Media は、ローカル再生 (ExoPlayer 経由)、ビデオ編集 (Transformer 経由)、メディア セッションなど、Android 上でメディア ユースケースを実装するためのライブラリのコレクションです。
既存の ExoPlayer および MediaSession ユーザー向けの移行ガイドは、developer.android.com にあります。
AndroidX Media リリースは API の安定性を保証し、最も一般的に使用される API に対して API サーフェスの下位互換性を確保します。より高度なユースケースを対象とした API は、不安定としてマークされます。不安定なメソッドまたはクラスを lint 警告なしで使用するには、使用する前に OptIn アノテーションを追加する必要があります。詳細については、UnstableApi のドキュメントを参照してください。
ライブラリは Google Maven リポジトリから取得できます。この GitHub リポジトリのクローンを作成して、モジュールをローカルに依存することもできます。
AndroidX Media の使用を開始する最も簡単な方法は、アプリ モジュールのbuild.gradle.ktsファイルに必要なライブラリの Gradle 依存関係を追加することです。
たとえば、DASH 再生サポートと UI コンポーネントを備えた ExoPlayer に依存するには、次のようにモジュールに依存関係を追加できます。
implementation( " androidx.media3:media3-exoplayer:1.X.X " )
implementation( " androidx.media3:media3-exoplayer-dash:1.X.X " )
implementation( " androidx.media3:media3-ui:1.X.X " )または、Gradle Groovy DSL build.gradleで次のようにします。
implementation ' androidx.media3:media3-exoplayer:1.X.X '
implementation ' androidx.media3:media3-exoplayer-dash:1.X.X '
implementation ' androidx.media3:media3-ui:1.X.X 'ここで、 1.XX優先バージョンです。すべてのモジュールは同じバージョンである必要があります。
ライブラリ モジュールの完全なリストなどの詳細については、AndroidX Media3 developer.android.com ページを参照してください。
このリポジトリには、手動で構築する必要があり、Maven リポジトリからは利用できない外部ライブラリに依存するモジュールがいくつか含まれています。詳細については、ライブラリ ディレクトリにある個々の README を参照してください。
まだ有効になっていない場合は、 androidセクションに次の行を追加して、AndroidX Media に応じてすべてのbuild.gradle.ktsファイルで Java 8 サポートを有効にする必要もあります。
compileOptions {
targetCompatibility = JavaVersion . VERSION_1_8
}または、Gradle Groovy DSL build.gradleで次のようにします。
compileOptions {
targetCompatibility JavaVersion . VERSION_1_8
}Gradle minSdkVersionが 20 以下の場合は、ビルド エラーを防ぐために multidex を有効にする必要があります。
一部のライブラリを使用する場合は、リポジトリをクローンしてモジュールをローカルに依存する必要があります。これは、ローカルに変更を加えたい場合、またはmainブランチを使用したい場合にも適したアプローチです。
まず、リポジトリのクローンをローカル ディレクトリに作成します。
git clone https://github.com/androidx/media.git次に、プロジェクトのsettings.gradle.ktsファイルに以下を追加し、 path/to/mediaローカル コピーへのパスに置き換えます。
(gradle as ExtensionAware ).extra[ " androidxMediaModulePrefix " ] = " media3- "
apply (from = file( " path/to/media/core_settings.gradle " ))または、Gradle Groovy DSL settings.gradleで次のようにします。
gradle . ext . androidxMediaModulePrefix = ' media3- '
apply from : file( " path/to/media/core_settings.gradle " ) AndroidX Media モジュールがプロジェクトの一部として表示されるはずです。他のローカル モジュールと同様に、 build.gradle.ktsからそれらに依存できます。次に例を示します。
implementation(project( " :media3-lib-exoplayer " ))
implementation(project( " :media3-lib-exoplayer-dash " ))
implementation(project( " :media3-lib-ui " ))または、Gradle Groovy DSL build.gradleで次のようにします。
implementation project( ' :media3-lib-exoplayer ' )
implementation project( ' :media3-lib-exoplayer-dash ' )
implementation project( ' :media3-lib-ui ' )追加の Maven リポジトリ設定が必要なため、デフォルトでは MIDI モジュールはローカル依存関係として無効になっています。これをローカルの依存関係として使用する場合は、モジュールの README の説明に従って JitPack リポジトリを設定し、 settings.gradle.ktsファイルでモジュールのビルドを有効にしてください。
gradle.extra. apply {
set( " androidxMediaEnableMidiModule " , true )
}または、Gradle Groovy DSL settings.gradleで次のようにします。
gradle . ext . androidxMediaEnableMidiModule = true 開発作業はmainブランチで行われます。通常、プル リクエストはこのブランチに対して行う必要があります。
releaseブランチには、最新の安定したリリースが保持されます。
Android Studio を使用して AndroidX メディアを開発するには、このリポジトリのルート ディレクトリでプロジェクトを開くだけです。
