ApsaraVideo Live:カスタム音声再生

概要

デフォルトでは、ARTC には実地検証済みの音声再生モジュールが組み込まれており、ほとんどの再生要件を満たします。ただし、既存のカスタム音声再生モジュールをお持ちの場合、または再生前に音声データを後処理する必要がある場合は、ARTC のカスタム音声再生機能をご利用ください。これにより、内部再生ロジックを無効化し、音声データの受信および再生を自社で管理できます。

その後、取得した音声データを再生デバイスに渡して処理および再生を行ってください。

サンプルコード

Android: Android/ARTCExample/AdvancedUsage/src/main/java/com/aliyun/artc/api/advancedusage/CustomAudioCaptureAndRender/CustomAudioRenderActivity.java。

iOS: iOS/ARTCExample/AdvancedUsage/CustomAudioRender/CustomAudioRenderVC.swift。

前提条件

カスタム音声再生を利用する前に、以下の要件を満たしていることを確認してください。

• 完全な音声再生モジュールを開発できるか、または既に確立されたサードパーティ製または社内開発の音声プレーヤーをお持ちであることです。

• PCM データ形式、サンプルレート、チャンネル数などの概念を含む基本的な音声処理ワークフローを理解していることです。

• ARTC SDK を統合済みであり、基本的な音声・映像通話機能を実装済みであることです。

• ご利用のユースケースにおいて、ARTC の内部再生モジュールをバイパスする必要があることです。該当しない場合は、安定性および互換性を確保するため、デフォルトの再生ソリューションをご利用ください。

実装

String extras = "{\"user_specified_use_external_audio_player\":\"TRUE\"}";
mAliRtcEngine = AliRtcEngine.getInstance(this, extras);

// エンジンの作成および初期化。
var customAudioPlayConfig: [String: String] = [:]
// 外部プレーヤーを使用し、SDK の内部再生を無効化します。
customAudioPlayConfig["user_specified_use_external_audio_player"] = "TRUE"
// JSON シリアル化。
guard let jsonData = try? JSONSerialization.data(withJSONObject: customAudioPlayConfig, options: []),
let extras = String(data: jsonData, encoding: .utf8) else {
    print("JSON シリアル化に失敗しました")
    return
}
let engine = AliRtcEngine.sharedInstance(self, extras:extras)

NSString * extras = @"{\"user_specified_use_external_audio_player\":\"TRUE\"}";
self.engine = [AliRtcEngine sharedInstance:self extras:extras];

std::string extras = "{\"user_specified_use_external_audio_player\":\"TRUE\"}";
mAliRtcEngine = AliRtcEngine.getInstance(this, extras.c_str());

// コールバック構成を設定します。
AliRtcEngine.AliRtcAudioFrameObserverConfig config = new AliRtcEngine.AliRtcAudioFrameObserverConfig();
config.sampleRate = AliRtcAudioSampleRate_48000;
config.channels = 1;
// 再生データコールバックを有効化するために登録します。
mAliRtcEngine.enableAudioFrameObserver(true, AliRtcAudioSourcePlayback, config);

// コールバック構成を設定します。
var observerConfig: AliRtcAudioFrameObserverConfig = AliRtcAudioFrameObserverConfig()
observerConfig.sampleRate = ._Unknown
observerConfig.channels = .monoAudio
// 再生データコールバックを有効化するために登録します。
let audioSource: AliRtcAudioSource = .playback
engine.enableAudioFrameObserver(true, audioSource: audioSource, config: observerConfig)

AliRtcAudioFrameObserverConfig* config = [[AliRtcAudioFrameObserverConfig alloc] init];
config.channels = audioNumChannel;
config.sampleRate = AliRtcAudioSampleRate_48000;
config.mode = AliRtcAudioFrameObserverOperationModeReadOnly;
[self.engine enableAudioFrameObserver:TRUE audioSource:AliRtcAudioSourcePlayback config:config];

// コールバック構成を設定します。
AliEngineAudioFrameObserverConfig config ;
config.sampleRate = AliRtcAudioSampleRate_48000;
config.channels = AliEngineMonoAudio;
// 再生データコールバックを有効化するために登録します。
mAliRtcEngine->EnableAudioFrameObserver(true, AliEngineAudioSourcePlayback, config);

@Override
public boolean onPlaybackAudioFrame(AliRtcEngine.AliRtcAudioFrame frame) {
    // コールバックで受信した音声データを再生するためのカスタム処理を実装します。

    return true;
}

func onPlaybackAudioFrame(_ frame: AliRtcAudioFrame) -> Bool {
    // コールバックで受信した音声データを再生するためのカスタム処理を実装します。
    
    return true
}

- (BOOL)onPlaybackAudioFrame:(AliRtcAudioFrame* _Nonnull)frame {
    // コールバックで受信した音声データを再生するためのカスタム処理を実装します。
    return true;
}

bool CTutorialDlg::OnPlaybackAudioFrame(AliEngineAudioRawData audioRawData) {
	// コールバックで受信した音声データを再生するためのカスタム処理を実装します。
	return true;
}

mAliRtcEngine.enableAudioFrameObserver(false, AliRtcAudioSourcePlayback, config)

engine.enableAudioFrameObserver(false, audioSource: audioSource, config: observerConfig)

[self.engine enableAudioFrameObserver:false audioSource:AliRtcAudioSourcePlayback config:config];

mAliRtcEngine->EnableAudioFrameObserver(false, AliEngineAudioSourcePlayback, config);

/* 内部再生を動的に無効化 */
String parameter = "{\"audio\":{\"enable_system_audio_device_play\":\"FALSE\"}}";
mAliRtcEngine.setParameter(parameter);

/* 内部再生を動的に有効化 */
String parameter = "{\"audio\":{\"enable_system_audio_device_play\":\"TRUE\"}}"; 
mAliRtcEngine.setParameter(parameter);

// 内部再生を動的に無効化。
engine.setParameter("{\"audio\":{\"enable_system_audio_device_play\":\"FALSE\"}}")
// 内部再生を動的に有効化。
engine.setParameter("{\"audio\":{\"enable_system_audio_device_play\":\"TRUE\"}}")

// 内部再生を動的に無効化。
[self.engine setParameter:"{\"audio\":{\"enable_system_audio_device_play\":\"FALSE\"}}"];
// 内部再生を動的に有効化。
[self.engine setParameter:"{\"audio\":{\"enable_system_audio_device_play\":\"TRUE\"}}"];

/* 内部再生を動的に無効化 */
std::string parameter = "{\"audio\":{\"enable_system_audio_device_play\":\"FALSE\"}}";
mAliRtcEngine->SetParameter(parameter.c_str());

/* 内部再生を動的に有効化 */
std::string parameter = "{\"audio\":{\"enable_system_audio_device_play\":\"TRUE\"}}"; 
mAliRtcEngine->SetParameter(parameter.c_str());