Mediarouter

API リファレンス
androidx.mediarouter.app
androidx.mediarouter.media

共通のユーザーインターフェースを使用して、リモートの受信デバイスでメディアの表示と再生を有効にします。

最新の更新	現在の安定版リリース	次のリリース候補	ベータ版リリース	アルファ版リリース
2021 年 9 月 1 日	1.2.5	-	-	-

依存関係の宣言

MediaRouter への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.mediarouter:mediarouter:1.2.5"
}

Kotlin

dependencies {
    implementation("androidx.mediarouter:mediarouter:1.2.5")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.2.4

バージョン 1.2.5

2021 年 9 月 1 日

androidx.mediarouter:mediarouter:1.2.5 がリリースされました。バージョン 1.2.5 に含まれる commit については、こちらをご覧ください。

バグの修正

転送するルートがない場合、出力スイッチャーのメディアルートボタンを非表示にします。
グループメンバーのルートの音量調整問題を修正しました。

バージョン 1.2.4

2021 年 6 月 16 日

androidx.mediarouter:mediarouter:1.2.4 がリリースされました。バージョン 1.2.4 に含まれるコミットについては、こちらをご覧ください。

バグの修正

MediaRouteButton が接続アニメーションをリプレイする問題を修正しました。
MediaRouteChooserDialog におけるルートの垂直方向の配置を修正しました。

バージョン 1.2.3

Mediarouter バージョン 1.2.3

2021 年 5 月 5 日

androidx.mediarouter:mediarouter:1.2.3 がリリースされました。バージョン 1.2.3 に含まれる commit については、こちらをご覧ください。

バグの修正

カスタマイズされた選択ツールダイアログの NullPointerException を修正しました。
接続状態であっても、接続が一時的に無効になっている場合に MediaRouteButton が接続解除状態を表示する問題を修正しました。

バージョン 1.2.2

Mediarouter バージョン 1.2.2

2021 年 2 月 10 日

androidx.mediarouter:mediarouter:1.2.2 がリリースされました。バージョン 1.2.2 に含まれる commit については、こちらをご覧ください。

バグの修正

OnDynamicRouteChangedListener.onRouteChanged が呼び出されたときに、選択済みのルートを再選択しません。

バージョン 1.2.1

2021 年 1 月 13 日

androidx.mediarouter:mediarouter:1.2.1 がリリースされました。バージョン 1.2.1 に含まれるコミットについては、こちらをご覧ください。

バグの修正

BT が利用可能なときに unselect() が呼び出された場合のスマートフォンスピーカーの選択を修正しました。
MediaRouter.Callback のタイミングを修正しました。Callback#onRouteSelected と Callback#onRouteUnselected は OnPrepareTransferListener#onPrepareTransfer の完了後に呼び出されます。

バージョン 1.2.0

2020 年 10 月 14 日

androidx.mediarouter:mediarouter:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.1.0 以降の主要な機能

シームレスなメディア転送がサポートされ、システム UI 経由でのメディア転送が可能になりました。詳しくはメディア動画の新機能をご覧ください。
コールバックの登録方法のガイダンスを変更しました。サンプルコードについては、MediaRouter.addCallback() の Javadoc をご覧ください。
選択されたルートが変更される直前にイベントを受信するために、新しいリスナー MediaRouter#OnPrepareTransferListener を追加しました。
ルーティング機能と UI タイプを示す MediaRouterParams を追加しました。
@RestrictTo(LIBRARY) による内部使用のみのメソッドの暫定的な使用を防止

バージョン 1.2.0-rc02

2020 年 10 月 1 日

androidx.mediarouter:mediarouter:1.2.0-rc02 がリリースされました。バージョン 1.2.0-rc02 に含まれるコミットについては、こちらをご覧ください。

バグの修正

ユーザーがシステム UI からのキャストを停止したときに RouteController#onUnselect が呼び出されないことがある問題を修正しました。

バージョン 1.2.0-rc01

2020 年 9 月 16 日

androidx.mediarouter:mediarouter:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

バグの修正

Bluetooth オーディオ機器を接続している際に現在のキャストが切断される問題を修正しました。
MediaRouteProvider#notifyDynamicRoutesChanged() で IllegalArgumentException をスローする問題を修正しました。
出力切り替えからのキャストの停止が機能するようになりました

バージョン 1.2.0-beta01

2020 年 9 月 2 日

androidx.mediarouter:mediarouter:1.2.0-beta01 がリリースされました。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

新機能

シームレスなメディア転送がサポートされ、システム UI 経由でのメディア転送が可能になりました。詳しくはメディア動画の新機能をご覧ください。

API の変更

MediaRouter.OnPrepareTransferListener で ListenableFuture を使用できます。

バグの修正

グループルートの音量調整を修正しました。
グループルートを作成すると、最初にグループルートが作成され、続いてメンバーのルートが作成されます。
出力の切り替えで「停止」が機能するようになりました。
予期せぬコールバックが呼び出されないように修正しました。
- ルーティングセッションが作成された場合の RouteController#onSelect
- キャストから電話に転送する場合の MediaRouter.Callback#onRouteSelected
- MediaRouter.Callback#onRouteSelected で正しいグループルート情報を使用
コールバックを削除

バージョン 1.2.0-alpha02

2020 年 7 月 22 日

androidx.mediarouter:mediarouter:1.2.0-alpha02 がリリースされました。バージョン 1.2.0-alpha02 に含まれるコミットについては、こちらをご覧ください。

API の変更

選択されたルートがリクエストされたルートと異なる場合に通知を受け取る新しい MediaRouter.Callback#onRouteSelected を追加しました。（Ieee16）
選択されたルートが変更される直前にイベントを受信するために、新しいリスナー MediaRouter#OnPrepareTransferListener を追加しました。（I6ace1）
MediaRouterParam を追加しました。（I33150）
コールバックの登録方法のガイダンスを変更しました。サンプルコードについては、MediaRouter.addCallback() の Javadoc をご覧ください。（I58112）

バージョン 1.2.0-alpha01

2020 年 4 月 15 日

androidx.mediarouter:mediarouter:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれるコミットについては、こちらをご覧ください。

API の変更

@RestrictTo(LIBRARY) による内部使用のみのメソッドの暫定的な使用を防止

バグの修正

キャストダイアログでの TalkBack に関する問題を解決
Lock で DynamicGroupRouterController のリスナーを保護

バージョン 1.1.0

2019 年 9 月 5 日

androidx.mediarouter:mediarouter:1.1.0 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

動的グループのサポート
- ユーザーがルートデバイスを動的に追加または削除できます。
- 動的グループを有効にするには、MediaRouteButton.enableDynamicGroup() を呼び出します。アプリは動的グループの新しいダイアログを表示します。
- インストールされた MediaRouteProvider は、機能を実際に有効にするために動的グループもサポートする必要があります。

バージョン 1.1.0-rc01

2019 年 6 月 13 日

androidx.mediarouter:mediarouter:1.1.0-rc01 がリリースされました。1.1.0-beta02 からの変更はありません。このバージョンに含まれる commit については、こちらをご覧ください。

バージョン 1.1.0-beta02

2019 年 6 月 5 日

androidx.mediarouter:mediarouter:1.1.0-beta02 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

MediaRouter ダイアログでの RTL 言語のサポート

バグの修正

MediaRoute ダイアログの下部のパディングを修正

バージョン 1.1.0-beta01

2019 年 5 月 7 日

androidx.mediarouter:mediarouter:1.1.0-alpha01 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

@NonNull としてマークされた null 引数の IllegalPointerException を NullPointerException に変更しました。

API の変更

DynamicRouteDescriptor のコールバックロジックが変更されました。MediaRouteProvider は、コールバックメソッドを直接呼び出すのではなく、MediaRouterProvider.DynamicGroupController.notifyDynamicRoutesChanged を呼び出すようになります。

バージョン 1.1.0-alpha03

2019 年 4 月 3 日

androidx.mediarouter:mediarouter:1.1.0-alpha03 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

バグの修正

MediaRouteVolumeSlider と RegisteredMediaRouteProvider のクラッシュを修正

バージョン 1.1.0-alpha02

2019 年 3 月 13 日

androidx.mediarouter:mediarouter:1.1.0-alpha02 がリリースされました。このバージョンに含まれる commit の完全なリストについては、こちらをご覧ください。

新機能

Android Studio のレイアウトプレビューでの MediaRouteButton のサポート

API の変更

enableDynamicGroup() メソッドが MediaRouteActionProvider と MediaRouteButton に追加され、動的グループ機能が有効になりました
setAlwaysVisible(boolean) メソッドが MediaRouteActionProvider と MediaRouteButton に追加され、MediaRouteButton を常に表示できるようになりました

バグの修正

MediaRouteCastDialog 行をクリックしやすくしました
onRouteChanged コールバックの不要な呼び出しを削除しました

バージョン 1.1.0-alpha01

2018 年 12 月 3 日

新機能

動的グループルートのサポートを追加
- MediaRouteProviders による動的グループルートをサポートする API を追加
- 動的グループルートのためのルートチューザとコントローラのダイアログ用に、新しい UX を追加