概要
GoogleのExoPlayerは、Android用のオープンソース、アプリケーションレベルのメディアプレーヤーです。Brightcoveは ExoPlayer を活用して、提供するメリットを活用しています。ExoPlayer にアップグレードする利点の詳細については、Brightcoveのネイティブ SDK と exoPlayer 2 のブログ記事を参照してください。
次のプロジェクトタイプで移行する方法を学びます。
を参照してくださいExoPlayerサンプルアプリケーション統合に関する追加のガイダンスについてはExoPlayer 2プロジェクトへのフレームワーク。
新しいプロジェクト
以下の手順に従って、新しい Android プロジェクトに exoPlayer 2 を追加します。
- build.gradleファイルで、次の依存関係を追加します。
transitive
オプションを設定すると、true
オフライン再生プラグインなどの他の依存関係を自動的に含めるようにgradleに指示します。5未満のgradleバージョンを使用している場合、推移的な依存関係はデフォルトでオフになっています。したがって、次のステートメントを追加する必要があります。- SDK バージョンに環境変数を使用している場合は、 gradle.properties ファイルを開き、Android 用 Native SDK の現在のバージョン値を設定します。これは次のようになります。
既存の exoPlayer 1 プロジェクト
ExoPlayer 2 フレームワークを使用するように既存の ExoPlayer 1 プロジェクトを更新するには、次の手順に従います。
- constants.gradleファイルで、Androidビルドツールのバージョンを更新します:
- build.gradleファイルで、Androidサポートライブラリを更新します。
定数の現在の値は、 constants.gradleファイルに見つけることができます。
- build.gradleファイルで、GoogleのMavenリポジトリを追加します。
- プロジェクトで Google IMA で広告を使用している場合は、Google Play サービス広告を更新してください。
- build.gradle ファイルで、以前に次のような依存関係として Brightcove ExoPlayer ライブラリをインポートしました。
依存関係の名前を変更します。
Brightcove SDK バージョン (
anpVersion
) の現在の値は、 gradle.properties ファイルにあります。 transitive
オプションを設定すると、true
オフライン再生プラグインなどの他の依存関係を自動的に含めるようにgradleに指示します。5未満のgradleバージョンを使用している場合、推移的な依存関係はデフォルトでオフになっています。したがって、次のものを追加する必要があります。- SDK バージョンに環境変数を使用している場合は、 gradle.properties ファイルを開き、Android 用 Native SDK の現在のバージョン値を設定します。これは次のようになります。
ExoPlayer 2 をプロジェクトに統合するために、追加のコーディングは必要ありません。
既存の MediaPlayer プロジェクト
ExoPlayer 2 フレームワークを使用するように既存の MediaPlayer プロジェクトを更新するには、次の手順に従います。
- build.gradleファイルで、次の依存関係を追加します。
transitive
オプションを設定すると、true
オフライン再生プラグインなどの他の依存関係を自動的に含めるようにgradleに指示します。5未満のgradleバージョンを使用している場合、推移的な依存関係はデフォルトでオフになっています。したがって、次のものを追加する必要があります。- SDK バージョンに環境変数を使用している場合は、 gradle.properties ファイルを開き、Android 用 Native SDK の現在のバージョン値を設定します。これは次のようになります。
- アプリで、 BrightcoveExoPlayerVideoViewの代わりにBrightcoveVideoView、Android MediaPlayerを使用します。
変更を破る
Android 版 Brightcove ネイティブ SDK に対する以下の変更により、ExoPlayer 2 の変更が壊れています。Brightcoveのネイティブ SDK では、ExoPlayer 1 の使用が廃止されました。
exoPlayerVideoDisplayComponent 内部リスナー
ExoPlayerVideoDisplayComponent
クラスを使用すると、ExoPlayer コンポーネントのステータスを取得するようにリスナーを設定できます。以下は、リスナーのいくつかのリストです:
リスナーを設定する | に関するステータス情報を受け取る |
---|---|
setデバッグリスナー | infolistener |
setCaptionリスナー | キャプションリスナー |
setMetadatalistener | Metadatalistener |
SetInternalErrorListener | InternalErrorListener |
以下は、ExoPlayer 2 の使用に関する推奨事項です。
infolistener
InfoListener
インターフェイスでは、次の変更が加えられました。
onAvailableRangeChanged
メソッドが削除されましたonLoadStarted
メソッドには、length
追加のパラメータがあります
例:exoPlayerVideoDisplayerComponent exoPlayer 2を使っている
キャプションリスナー
CaptionListener
インターフェイスは変更されません。
例:exoPlayerVideoDisplayer v2 を使っているコンポーネント
Metadatalistener
MetadataListener
インターフェイスは exoPlayer v2 で導入されました。Id3MetadataListener
以前の使用は廃止されました。
例:exoPlayerVideoDisplayer v2 を使っているコンポーネント
新しいとMetadataListener
あなたは受け取るでしょうMetadadata
のオブジェクトonMetadata
折り返し電話。非推奨ではId3MetadataListener
、Id3Frame オブジェクトのリストを受け取りました。以下に示すように、新しいリスナーを使用すると、Id3Frame
まだオブジェクトのリストを取得することができます。
InternalErrorListener
InternalErrorListener
インターフェイスには多くの変更点があります。比較については、以下のコードをご確認ください。
exoPlayerVideoDisplayer v2 を使っているコンポーネント
exoPlayerVideoDisplayer v1 を使用するコンポーネント ( 非推奨 )
ExoPlayer 2 を使用する場合、onPlayerError(Exception e)
発生する例外の種類はですがcom.google.android.exoplayer2.ExoPlaybackException
、これは将来変更される可能性があります。
com.google.android.exoPlayer2.expackException を使用すると、次の例外タイプを取得できます。
ExoPlaybackException.TYPE_SOURCE
ExoPlaybackException.TYPE_RENDERER
ExoPlaybackException.TYPE_UNEXPECTED
Throwable
でオブジェクトを取得することで、エラーの原因を取得することもできますExoPlaybackException.getSourceException()
。
オフライン再生のサポート
プロジェクトで、MediaDownloadable.setConfigurationBundle(Bundle)
ビデオビットレートなどのダウンロード設定を指定する方法を使用している場合は、次のようにコードを更新してください。
古い形式 (非推奨)
新しいフォーマット
レガシーメディア API クラス
で廃止されたレガシー Media API クラスは、Android 用 Brightcove ネイティブ SDK から削除されました。com.brightcove.player.media package
Media クラスを使用していた場合は、クラスを移行して使用を開始する必要があります。com.brightcove.player.edge.Catalog
com.brightcove.player.media
次のクラスがからに移動されましたcom.brightcove.player.model
:
DeliveryType.java
CaptionType.java
ErrorFields.java
VideoFields.java
その他のリソース
ExoPlayer 2 フレームワークの使用の詳細については、次のドキュメントを参照してください。