包含クラス: : 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).