ApsaraVideo Live:一般的なオーディオ操作と構成

1.1. オーディオエンコーディングモード (AliRtcAudioProfile)

1.2. オーディオシナリオモード (AliRtcAudioScenario)

1.3. サンプルコード

次のコードは、一般的なシナリオでオーディオエンコーディングとシナリオモードを設定する方法の例を示しています。

Bluetooth オーディオキャプチャ

// シナリオを AliRtcSceneDefaultMode に設定します。
mAliRtcEngine.setAudioProfile(AliRtcEngineHighQualityMode, AliRtcSceneDefaultMode);

// シナリオを AliRtcSceneDefaultMode に設定します。
engine.setAudioProfile(AliRtcAudioProfile.engineHighQualityMode, audio_scene: AliRtcAudioScenario.sceneDefaultMode)

Web クライアントとの相互運用性

// エンコーディングモードを 48 kHz のサンプルレートを持つもの (AliRtcEngineHighQualityMode など) に設定します。
mAliRtcEngine.setAudioProfile(AliRtcEngineHighQualityMode, AliRtcSceneMusicMode);

// エンコーディングモードを 48 kHz のサンプルレートを持つもの (AliRtcEngineHighQualityMode など) に設定します。
engine.setAudioProfile(AliRtcAudioProfile.engineHighQualityMode, audio_scene: AliRtcAudioScenario.sceneMusicMode)

デュアルチャンネルオーディオ

// モードをステレオを含むもの (AliRtcEngineStereoHighQualityMode など) に設定します。
mAliRtcEngine.setAudioProfile(AliRtcEngineStereoHighQualityMode, AliRtcSceneMusicMode);

// モードをステレオを含むもの (AliRtcEngineStereoHighQualityMode など) に設定します。
engine.setAudioProfile(AliRtcAudioProfile.engineStereoHighQualityMode, audio_scene: AliRtcAudioScenario.sceneMusicMode)

2.1. マイクのミュート

muteLocalMic メソッドを使用して、マイクと外部オーディオ入力をミュートできます。このメソッドは、チャンネルに参加する前または後に呼び出して、ミュート状態を設定できます。

サポートされている AliRtcMuteLocalAudioMode モードは次のとおりです。

以下はサンプルコードです。

// すべてミュート
mAliRtcEngine.muteLocalMic(true, AliRtcEngine.AliRtcMuteLocalAudioMode.AliRtcMuteAllAudioMode);
// すべてミュート解除
mAliRtcEngine.muteLocalMic(false, AliRtcEngine.AliRtcMuteLocalAudioMode.AliRtcMuteAllAudioMode);
// マイクのみミュート
mAliRtcEngine.muteLocalMic(true, AliRtcEngine.AliRtcMuteLocalAudioMode.AliRtcMuteOnlyMicAudioMode);

2.2. マイクキャプチャの無効化または再開

@startuml
autonumber
actor "開発者クライアント" as userA #cyan
participant "ARTC SDK" as artcsdk #orange

userA -> artcsdk: ARTC エンジンを作成
userA -> artcsdk: joinChannel を呼び出してチャンネルに参加し、オーディオストリームをプッシュ
userA -[#red]> artcsdk: <color:#red>stopAudioCapture を呼び出してマイクキャプチャを無効化
userA -[#red]> artcsdk: <color:#red>startAudioCapture を呼び出してマイクキャプチャを再開
@enduml

デフォルトでは、ユーザーがチャンネルに参加すると、SDK はマイクキャプチャを有効にします。マイクキャプチャを無効にするには、stopAudioCapture メソッドを呼び出します。このメソッドはマイクのリソースを解放し、オーディオキャプチャを停止します。マイクキャプチャを再開するには、startAudioCapture メソッドを呼び出します。

// マイクキャプチャを無効化
mAliRtcEngine.stopAudioCapture();
// マイクキャプチャを再開
mAliRtcEngine.startAudioCapture();

3.1. リモートユーザーのミュート

muteRemoteAudioPlaying メソッドを使用して、指定したリモートユーザーからのオーディオ再生を停止または再開できます。メソッドは次のように定義されます。

public abstract int muteRemoteAudioPlaying(String uid, boolean mute);

• ミュートは、オーディオストリームのフェッチングやデコードには影響しません。このメソッドは、チャンネルに参加する前または後に呼び出すことができます。

• ミュートは、ローカルクライアントでのリモートユーザーからのオーディオ再生にのみ影響します。リモートユーザーのオーディオキャプチャには影響しません。

3.2. 指定したリモートユーザーの再生音量を設定する

setPlayoutVolume メソッドを使用して、ローカルの再生音量を制御できます。

/**
 * @brief 再生音量を設定します。
 * @param volume 再生音量。値の範囲は 0 から 400 です。
 * - 0: ミュート
 * - <100: 音量を下げます。
 * - >100: 音量を上げます。
 * @return
 * - 0: 成功
 * - 0 以外の値: 失敗
 */
public abstract int setPlayoutVolume(int volume);

setRemoteAudioVolume メソッドを使用して、指定したリモートユーザーの再生音量を制御できます。volume パラメーターを 0 に設定すると、muteRemoteAudioPlaying メソッドを呼び出すのと同じ効果があります。

/**
 * @brief ローカルクライアントで再生される指定されたリモートユーザーのオーディオの音量を調整します。
 * @param uid ユーザー ID。これは、アプリサーバーによって割り当てられた一意の識別子です。
 * @param volume 再生音量。値の範囲は 0 から 100 です。0 はミュートを意味します。100 は元の音量を意味します。
 * @return
 * - 0: 成功
 * - 0 以外の値: 失敗
 */
public abstract int setRemoteAudioVolume(String uid, int volume);

4.1. インイヤーモニターの有効化

チャンネルに参加する前または後に enableEarBack メソッドを呼び出して、インイヤーモニターを有効にすることができます。この機能を無効にするには、enableEarBack メソッドを再度呼び出し、パラメーターを false に設定します。

rtcEngine.enableEarBack(true);

engine.enableEarBack(true)

4.2. インイヤーモニターの音量を設定する

setEarBackVolume メソッドを呼び出して、インイヤーモニターの音量を調整できます。volume パラメーターは音量レベルを指定し、範囲は 0 から 100 です。値 0 はミュートを示し、100 は元の音量を示します。デフォルト値は 100 です。

rtcEngine.setEarBackVolume(60);

rtcEngine?.setEarBackVolume(volume)

5.1. コールバックの有効化

enableAudioVolumeIndication メソッドを呼び出して機能を有効にし、コールバックの頻度や平滑化係数などのパラメーターを設定できます。メソッドのパラメーターは次のとおりです。

• interval: コールバック間隔 (ミリ秒、ms)。300 ms から 500 ms の間の値に設定することをお勧めします。最小値は 10 ms です。このパラメーターに負の値を設定すると、機能が無効になります。

• smooth: 平滑化係数。値が大きいほど平滑化が強くなります。値が小さいほど平滑化が弱くなり、リアルタイムパフォーマンスが向上します。3 に設定することをお勧めします。値の範囲は 0 から 9 です。

• reportVad: アクティブスピーカー検出スイッチ。このパラメーターを 0 に設定すると機能が無効になり、1 に設定すると有効になります。

mAliRtcEngine.enableAudioVolumeIndication(500, 3,1);

// ユーザー音量コールバックとアクティブスピーカー検出
engine.enableAudioVolumeIndication(500, smooth: 3, reportVad: 1)

5.2. コールバックの実装と登録

registerAudioVolumeObserver メソッドを呼び出して、関連するコールバックを登録できます。システムは、指定された間隔でコールバックをトリガーします。

• onAudioVolume コールバックは、定期的にオーディオ音量情報を提供します。このコールバックを使用して、各ユーザーの発話強度をリアルタイムで監視できます。システムは、ローカルとリモートの両方で検出されたすべてのユーザーの音量レベルを定期的に報告します。この情報を使用して、音波アニメーション、音量インジケーター、ミュート検出などの UI フィードバックを実装できます。`mUserId` が "0" の場合、音量はローカルユーザーのものです。`mUserId` が "1" の場合、音量はすべてのリモートユーザーの混合音量です。その他の値は、特定のリモートユーザーの音量を表します。`totalVolume` は、すべてのリモートユーザーからのオーディオが混合された後の合計音量です。

• onActiveSpeaker コールバックは、新しいアクティブスピーカーが検出されたときに、音声アクティビティ検出 (VAD) 機能によってトリガーされます。システムがユーザーの発話音量と持続時間が指定されたしきい値を超えたことを検出すると、SDK はこのコールバックを通じてアプリケーションに通知します。このイベントを使用して、会議でスピーカーのビデオウィンドウに自動的にフォーカスするなどの機能を実装できます。

private final AliRtcEngine.AliRtcAudioVolumeObserver mAliRtcAudioVolumeObserver = new AliRtcEngine.AliRtcAudioVolumeObserver() {
    // ユーザー音量コールバック
    @Override
    public void onAudioVolume(List<AliRtcEngine.AliRtcAudioVolume> speakers, int totalVolume){
        handler.post(() -> {
            if(!speakers.isEmpty()) {
                for(AliRtcEngine.AliRtcAudioVolume volume : speakers) {
                    if("0".equals(volume.mUserId)) {
                        // 現在のローカルユーザーの音量

                    } else if ("1".equals(volume.mUserId)) {
                        // リモートユーザーの全体的な音量

                    } else {
                        // リモートユーザーの音量

                    }
                }
            }
        });
    }

    // アクティブスピーカー検出コールバック
    @Override
    public void onActiveSpeaker(String uid){
        // アクティブスピーカー
        handler.post(() -> {
            String mag = "onActiveSpeaker uid:" + uid;
            ToastHelper.showToast(AudioBasicUsageActivity.this, mag, Toast.LENGTH_SHORT);
        });
    }
};
// コールバックを登録
mAliRtcEngine.registerAudioVolumeObserver(mAliRtcAudioVolumeObserver);

func onAudioVolumeCallback(_ array: [AliRtcUserVolumeInfo]?, totalVolume: Int32) {
    // ユーザー音量コールバック
    "onAudioVolumeCallback, totalVolume: \(totalVolume)".printLog()
}

func onActiveSpeaker(_ uid: String) {
    // アクティブスピーカーコールバック
    "onActiveSpeaker, uid: \(uid)".printLog()
}

6.1. デフォルトのオーディオルート

チャンネルに参加する前に、デフォルトのオーディオルートをイヤピースまたはスピーカーに設定できます。デフォルトルートを設定しない場合、デフォルトでスピーカーが使用されます。

/**
* @brief デフォルトのオーディオ出力がスピーカーであるかどうかを設定します。デフォルトはスピーカーです。
* @param defaultToSpeakerphone
* - true: スピーカーモード (デフォルト)
* - false: イヤピースモード
* @return
* - 0: 成功
* - <0: 失敗
*/
public int setDefaultAudioRoutetoSpeakerphone(boolean defaultToSpeakerphone);

6.2. 現在のオーディオルート

チャンネル内で現在のオーディオルートをイヤピースまたはスピーカーに設定できます。現在のルートを設定しない場合、デフォルトのオーディオルートが使用されます。

外部デバイスが接続されていない場合、enableSpeakerphone メソッドを呼び出してスピーカーを使用できます。パラメーターを false に設定するとイヤピースが使用されます。現在のオーディオデバイスがスピーカーであるかどうかを確認するには、isSpeakerOn メソッドを呼び出します。

/**
 * @brief オーディオ出力をイヤピースまたはスピーカーに設定します。
 * @param enable   true: スピーカーモード (デフォルト); false: イヤピースモード
 * @return
 * - 0: 成功
 * - <0: 失敗
 */
public int enableSpeakerphone(boolean enable);
/**
* @brief 現在のオーディオ出力がイヤピースかスピーカーかを取得します。
* @return 
* - true: スピーカーモード;
* - false: イヤピースモード
*/
public boolean isSpeakerOn();

6.3. オーディオルート変更コールバック

オーディオ再生デバイスが変更されたときにコールバックを受信するには、次のコールバックを登録してリッスンします。

public abstract class AliRtcEngineEventListener {
    /**
     * @brief 警告通知。
     * @details エンジンで警告が発生した場合、アプリはこのコールバックを通じて通知されます。
     * @param warn 警告タイプ。
     * @param message 警告メッセージ。
     */
    public void onOccurWarning(int warn, String message);
}

次の表は、`warn` の戻り値とデバイスタイプのマッピングを示しています。