ComposeでのPicture in Picture

Transcript

1. Composeでの Picture in Picture 2025/04/25 DroidKaigi.collect { #18@Tokyo }
2. 自己紹介 正木清駿(まさききよたか) 所属：DMM.com Android歴：約6年 ここ4年ほど動画プレイヤーに携わってます。
3. 本日話すこと 1. Picture in Picture(PiP)とは 2. 主な実装方法 3. アプリから離脱したことを検知する 4. PiPモードになったことを検知する 5. Composeでどう行うか？ ◦ OnUserLeaveHintProvider, OnPictureInPictureModeChangedProvider
4. Picture in Picture(PiP)とは • Android 8.0以降で対応しているマルチウィンドウ モードの一種 • 他のアプリを操作しながら小さい画面でアプリの操作 を可能にする機能 ◦ 主に動画再生アプリなどで実装されることが多い
5. 実装の流れ 1. ManifestにPiP対応するAcitivityの設定を追加 2. 特定のイベントが発生した時にPiPを起動させる a. 例えばAndroid 12 未満の場合アプリから離脱した時を検知 b. アスペクト比など起動時のパラメーターを設定 c. PiP起動メソッドを実行 ▪ 12以上はsetAutoEnterEnabledを設定することで自動でPiPが起動する 3. PiP起動中のUIの制御をする a. アプリがPiPモードになったことを検知 b. 画面サイズに応じたUIコンポーネントのサイズや配置を実装
6. 実装の流れ 1. ManifestにPiP対応するAcitivityの設定を追加 2. 特定のイベントが発生した時に PiPを起動させる a. 例えばAndroid 12 未満の場合アプリから離脱した時を検知 b. アスペクト比など起動時のパラメーターを設定 c. PiP起動メソッドを実行 ▪ 12以上はsetAutoEnterEnabledを設定することで自動で PiPが起動する 3. PiP起動中のUIの制御をする a. アプリがPiPモードになったことを検知 b. 画面サイズに応じた UIコンポーネントのサイズや配置を実装
7. アプリから離脱したことを検知する Activity.onUserLeaveHintを利用する • API Level 3から存在 • Activityがバックグラウンドに移行しようとするときに呼び出される。 ◦ アプリ起動中に別アプリの通知をタップして起動 ◦ ホームボタンを押下した時(今時ないかもだが)
8. PinP モードになったこと(復帰したこと)を検知する Activity.onPictureInPictureModeChangedを利用する • API level 26(24)から存在 • ActivityがPiPモードに入った時、PiPモードから戻った時に呼び出される
11. この方法だとComposeで利用するには面倒 Activityのメソッドオーバーライドで実装する場合はSingleActivity + Composeのような 設計の場合に利用するには面倒 - PiPはアプリ全体ではなく、特定の画面でのみ利用したいケースが大半 - プレイヤーだけPiP機能を提供し、その他のページではPiPを起動させたくない - onUserLeaveHint, onPictureInPictureModeChangedを個別の画面ごとに扱うに は親のActivityで発生したイベントを子のViewに持っていく仕組みが必要
12. OnUserLeaveHintProvider, OnPictureInPictureModeChangedProvider そこで
13. アプリから離脱したことを検知する(改) OnUserLeaveHintProviderを利用する - android.core.core 1.13.0で追加された - Activity.onUserLeaveHintからの呼び出しをディスパッチできるコンポー ネントのインターフェース(原文ママ) - androidx.activity 1.9.0 からComponentActivityに継承されている
15. PinPモードになったことを検知する(改) OnPictureInPictureModeChangedProvider を利用する - android.core.core 1.13.0で追加された - Activity.onPictureInPictureModeChangedからの呼び出しをディスパッチできる コンポーネントのインターフェース(原文ママ) - androidx.activity 1.5.0 からComponentActivityに継承されている
19. まとめ ComposeでPiP対応する場合は - OnUserLeaveHintProvider - OnPictureInPictureModeChangedProvider を使うとよい