スマートデバイスの AudioController コントロール

スマートデバイスアプリケーションでオーディオを操作するには、ユーザーエクスペリエンスに優れていると同時に、開発者にとってシンプルなメディアプレーヤーが必要です。
AudioController コントロールの目的は、各機能 (再生、一時停止、停止など) に対応する標準のメディアボタンをすべて表示するとともに、高度な機能やカスタマイズできる柔軟性を組み込むことです。

モード

Android	iOS
		ミニプレーヤー
		全画面プレーヤー

戻るボタンの動作

戻るボタンには、曲の進行状況に応じて 2 つの状態があります。

再開: 曲が 3 秒以上再生されていた場合は、戻るボタンで、その曲を最初から再生します。
前の曲: 曲の再生時間が 3 秒未満の場合は、戻るボタンで、前の曲に戻ります。

曲がキューの先頭にある場合、再生を開始してから 3 秒が経過した時点で戻るボタンが有効になります。

表示のカスタマイズ

GeneXus は、レイアウトに AudioController が埋め込まれていることを検出すると、AudioController という新しいスーパークラスをテーマに自動的に作成します。このスーパークラスには次のプロパティがあります:

ミニプレーヤー
Title Label Class	ミニプレーヤーで再生、表示されている MediaItem のタイトルに適用する TextBlock サブクラスです。
Subtitle Label Class	Title Label Class と同様ですが、サブタイトルに適用されます。
Image Class	ミニプレーヤーで再生、表示されている MediaItem の画像に適用する Image サブクラスです。
Play / Pause Button Class	ミニプレーヤーの再生ボタンと一時停止ボタンに適用する Button サブクラスです。

全画面プレーヤー
Title Label Class	ミニプレーヤーの Title Label Class と同様ですが、全画面プレーヤーが対象です。
Subtitle Label Class	ミニプレーヤーの Subtitle Label Class と同様ですが、全画面プレーヤーが対象です。
Image Class	ミニプレーヤーの Image Class と同様ですが、全画面プレーヤーが対象です。
Play / Pause Button Class	ミニプレーヤーの Play / Pause Button Class と同様ですが、全画面プレーヤーが対象です。
Other Buttons Class	全画面プレーヤー内のほかのボタン (巻き戻し、早送りなど) に適用する Button サブクラスです。

注: テーマのサブクラスには、考慮されないプロパティもあります。次の表に、前述の各サブクラスで考慮されるプロパティを示します。

	サブクラス	TextBlock サブクラス	Image サブクラス	Button サブクラス
	考慮されるプロパティ	Forecolor Font Family Size TextDecoration Weight, Style Category	Margin Top Bottom Right Left ScaleType Placeholder Image Image Loading Indicator 制限: Android のみ	Margin Top Bottom Right Left Forecolor

カスタマイズ例

最初に、AudioController スーパークラスに必要な各フィールドに対応するクラスを作成します。

次に、対応するフィールドでこれらのクラスを設定します。

これにより、AudioController で次の結果が得られます。

Android	iOS
		ミニプレーヤー
		全画面プレーヤー

クイックアクセス

AudioController コントロールが設定されたアプリケーションでは、キューの設定時にプレーヤーのクイックアクセスが自動的に有効になります。このウィジェットには、再生中の曲が、その情報と進行状況とともに表示されます。

Android (ツールバーより)	iOS (コントロールセンターより)

警告: OS (オペレーティングシステム) で管理されているこの固有のプレーヤーと、GeneXus が提供するプレーヤーを混同しないでください。AudioController コントロールは、メディアアイテムのタイトル、サブタイトル、画像のみを表示します。ミニモードは再生/一時停止ボタンを追加し、全画面モードには、戻る、進む、繰り返し、シャッフル再生などのボタンも含まれます。

注

メディアアイテムの再生中にデバイスがロックされ、オーディオが中断された場合 (電話の着信など) の動作は次のようになります。
- iOS 10 以上のバージョンでは、オーディオが回復したときに自動的に再開されます。
- iOS 9 以前のバージョンでは、中断が終了したら、プレーヤーの再生ボタンを使ってオーディオを手動で再開する必要があります。
iOS の場合、エンドユーザーがアプリケーション以外でプレーヤーを使用できるようにするには、開発者がオーディオのバックグラウンド再生モードを有効にする必要があります。そのためには、[ Background Modes ] プロパティに値 audio を追加します。

適用範囲

オブジェクト: Panel for Smart Devices、Work With for Smart Devices
対応しているプラットフォーム: スマートデバイス (iOS、Android)

使用可能バージョン

この API は、GeneXus 15 以降で利用できます。