オーディオデバイス。 続きを読む...

#include <stdlib.h> #include "config.h" #include "base.h"
型定義
typedef struct otc_audio_device otc_audio_device
機能
size_t otc_audio_device_read_render_data (int16_t *buffer, size_t number_of_samples)
otc_status otc_audio_device_write_capture_data (const int16_t *buffer, size_t number_of_samples)
otc_status otc_set_audio_device (const struct otc_audio_device_callbacks *コールバック)
otc_status otc_audio_device_restart_input ()
otc_status otc_audio_device_restart_output ()

詳細な説明

オーディオデバイス。

このファイルには、オーディオデバイスの型定義に加え、そのデバイスで使用するための構造体や関数が含まれています。

オーディオデバイスを使用して、すべてのパブリッシャー向けのカスタムオーディオキャプチャ機能と、すべてのパブリッシャーおよびサブスクライバー向けのカスタムオーディオレンダリング機能を定義します。カスタムオーディオデバイスを使用しない場合、アプリケーションはシステムのマイクとスピーカーを使用するデフォルトのオーディオデバイスを使用します。

クライアントが接続するセッション内のすべてのパブリッシャーおよびサブスクライバーに対して、カスタムオーディオが使用されます。オーディオデバイスが一度設定されると、その設定はグローバルに適用されます。設定されたオーディオデバイスのキャプチャおよびレンダリング設定は、そのセッションのすべての参加者のオーディオのレンダリングおよびキャプチャに使用されます。特定のパブリッシャーやサブスクライバーのみを対象にオーディオデバイスを設定することはできません。

のインスタンスを作成する otc_audio_device_callbacks 構造体を作成し、オーディオデバイスに関連するイベントのコールバック関数を設定します。その後、otc_set_audio_device(const struct otc_audio_device_callbacks callbacks) を呼び出して、使用するオーディオデバイスにコールバックを関連付けます。 この関数は、セッションに接続する前に呼び出す必要があります。また、これはグローバルな操作であり、アプリケーションの存続期間を通じて維持される必要があります。

に電話する。 otc_audio_device_read_render_data レンダリングされていないオーディオサンプルを取得する関数。

に電話する。 otc_audio_device_write_capture_data 公開するストリームに含めるオーディオサンプルを書き込む関数。

Typedef のドキュメント

otc_audio_device

オーディオデバイスのタイプ定義。

関数のドキュメント

otc_audio_device_read_render_data()
size_t otc_audio_device_read_render_data ( int16_t * バッファ,
size_t サンプル数
)

セッションから、まだレンダリングされていないオーディオサンプルを取得します。これらのサンプルは、サブスクライブしているセッション内のストリームからミックスされたものです。

パラメータ : | | | | --- | --- | | buffer | オーディオデータを含むバッファ。 | | number_of_samples | 要求されるサンプル数。 |

戻り値 : オーディオバッファからコピーされたサンプル数。

otc_audio_device_restart_input()
otc_status otc_audio_device_restart_input ( )

オーディオ入力デバイスを再起動します。カスタムオーディオデバイスで入力デバイスの変更が発生した際は、SDKが新しいデバイスに対して必要な補正処理を実行できるように、必ずこのメソッドを呼び出す必要があります。また、これにより以下の処理がトリガーされます。 otc_audio_device_callbacks メソッドを順に：

  • stop_capturer

  • init_capturer（is_capturer_initialized が false を返す場合のみ）

  • start_capturer（is_capturer_started が false を返す場合のみ）

    戻り値 : エラーか成功かを示す戻り値。

otc_audio_device_restart_output()
otc_status otc_audio_device_restart_output ( )

オーディオ出力デバイスを再起動します。カスタムオーディオデバイスで出力デバイスの変更が発生した際は、SDKが新しいデバイスに対して必要な補正を行えるように、必ずこのメソッドを呼び出す必要があります。また、これにより以下の処理がトリガーされます。 otc_audio_device_callbacks メソッドを順に：

  • stop_renderer

  • init_renderer（is_renderer_initialized が false を返す場合のみ）

  • start_renderer（is_renderer_started が false を返す場合のみ）

    戻り値 : エラーか成功かを示す戻り値。

otc_audio_device_write_capture_data()
otc_status otc_audio_device_write_capture_data ( const int16_t * バッファ,
size_t サンプル数
)

オーディオデバイスからのオーディオデータをセッションに送信するために渡します。このオーディオデータは、セッションに公開するストリームで使用されます。

パラメータ : | | | | --- | --- | | buffer | オーディオデータを含むバッファ。 | | number_of_samples | コピー可能なサンプル数。 |

戻り値 : エラーか成功かを示す戻り値。

otc_set_audio_device()
otc_status otc_set_audio_device ( const struct otc_audio_device_callbacks * コールバック )

使用するオーディオデバイスを設定します。セッションに接続する前に、この関数を呼び出す必要があります。また、これはグローバルな操作であり、セッションの存続期間を通じて維持される必要があります。

パラメータ : | | | | --- | --- | | callbacks | オーディオデバイス関数のコールバック構造体へのポインタ。 |

戻り値 : エラーか成功かを示す戻り値。