包含クラス: : BaseAudioDevice
public static interface BaseAudioDevice.AudioFocusManager
アプリにオーディオフォーカスの制御を委譲するために使用します。このオブジェクトは、 AudioDeviceManager.getAudioFocusManager().
関連項目: : - AndroidのConnectionServiceを使用したVoIPアプリの作成
方法の概要
すべてのメソッド インスタンスメソッド 抽象メソッド
修飾子と型
方法
説明
void
audioFocusActivated()
オーディオのフォーカスが取得されたことをSDKに通知します。
void
audioFocusDeactivated()
オーディオのフォーカスが失われたことをSDKに通知します。
void
setRequestAudioFocus(boolean requestAudioFocus)
外部からオーディオフォーカスが要求された場合、オーディオデバイスに通知します。
メソッドの詳細
setRequestAudioFocus
void setRequestAudioFocus(boolean requestAudioFocus)
外部からオーディオフォーカスの要求があった場合、オーディオデバイスに通知します。 このメソッドは、SDKが自動的にオーディオフォーカスを要求するか、 それともその処理をアプリケーションに委ねるかを決定します(たとえば、ConnectionServiceとの連携時など)。
外部オーディオのフォーカス管理に関して、Vonage SDK はオーディオ出力のルーティングを自動的に処理しません。
ConnectionServices を使用する場合は、Telecom フレームワークの
組み込みのオーディオルーティング機能を活用する必要があります。このプラットフォームは、アプリに対して、
利用可能なオーディオルートの統合リストを提供します(例:
Connection.onAvailableCallEndpointsChanged(List)) およびオーディオ経路を切り替えるための
標準化された方法(例えば、
Connection.requestCallEndpointChange(CallEndpoint, Executor, OutcomeReceiver)).
パラメータ:
: requestAudioFocus - オーディオデバイスがオーディオフォーカスを要求するかどうか。自動的なオーディオフォーカス管理を行う場合は
true を、ConnectionService など、外部(手動)による
起動が必要な場合は false を指定します。デフォルトでは、
SDK によって内部的にオーディオフォーカスが要求されます。
**Note:** This method should be called early in the application's lifecycle, typically
during app launch or before initiating any audio/video sessions.
audioFocusActivated
void audioFocusActivated()
オーディオのフォーカスが取得されたことをSDKに通知します。
このメソッドは、システム(たとえばConnectionServiceを介して)が
オーディオフォーカスを有効にした際に呼び出す必要があります。これにより、SDKに対して、オーディオが使用可能になり、
フォーカスがアクティブになったことが通知されます。これは、
AudioManager.AUDIOFOCUS_GAIN 状態が
AudioManager.OnAudioFocusChangeListener または、呼び出しの後
AudioManager.requestAudioFocus(AudioFocusRequest focusRequest).
注: この方法は、以下を呼び出す場合にのみ適用されます。
setRequestAudioFocus(false).
オーディオフォーカスの手動ハンドルを要求せずに呼び出された場合、
SDKがオーディオフォーカスの有効化を自動的に処理するため、この呼び出しは無視されます。
audioFocusDeactivated
void audioFocusDeactivated()
オーディオのフォーカスが失われたことをSDKに通知します。
このメソッドは、ConnectionService がオーディオフォーカスを失った際に呼び出す必要があります。
これは、オーディオフォーカスがもはやアクティブではなく、リセットする必要があることを SDK に通知するために使用されます。
以下の場合に呼び出す必要があります。
AudioManager.AUDIOFOCUS_LOSS 状態が
AudioManager.OnAudioFocusChangeListener または、呼び出しの後
AudioManager.abandonAudioFocusRequest(AudioFocusRequest focusRequest).