AOQ Web SDK は、ブラウザーでのリアルタイム音声、映像、データのやり取りをサポートします。本リファレンスでは、エンジン管理、音声・映像のキャプチャと再生、データメッセージ、イベントコールバックの API を説明します。
SDK のインストール
AOQ Web SDK は WebTransport(HTTP/3 / QUIC)でサーバーに接続し、Worker 内で音声、映像、データメッセージを送受信します。WebTransport 対応ブラウザーと HTTPS のセキュアコンテキストが必要です。AoqClientEngine.isAoqSupported() でブラウザーの基本機能を確認できます。
npm で SDK をインストールします。
API 一覧
エンジンのライフサイクル
| API | 説明 |
|---|---|
| createEngine | シングルトンエンジンの作成 |
| createAoqClientEngine | 同等の名前付きファクトリー関数 |
| destroy | エンジンの破棄 |
| getVersion | SDK バージョンの取得 |
| isAoqSupported | ブラウザー機能の確認 |
| connect | 接続の開始 |
| disconnect | 切断 |
音声デバイスの管理
| API | 説明 |
|---|---|
| startAudioCapture | 音声キャプチャの開始 |
| stopAudioCapture | 音声キャプチャの停止 |
| muteAudioCapture | 音声キャプチャのミュート |
| startAudioPlayer | 音声再生の開始 |
| stopAudioPlayer | 音声再生の停止 |
| pauseAudioPlayer | フェードアウト付き再生一時停止 |
| resumeAudioPlayer | デフォルトのフェードインで再生再開 |
| interruptAudioPlayer | 再生の中断 |
音声エンコード設定
| API | 説明 |
|---|---|
| setAudioEncoderConfig | 音声エンコードパラメーターの設定 |
| setAudioDecoderConfig | 音声デコードパラメーターの設定 |
ローカル音量通知
| API | 説明 |
|---|---|
| enableLocalAudioVolumeIndication | ローカル音量通知の有効化 |
映像デバイスの管理
| API | 説明 |
|---|---|
| startVideoCapture | 映像キャプチャの開始 |
| getCameras | カメラの列挙 |
| switchCamera | 向きの優先設定またはデバイス ID によるカメラ切り替え |
| stopVideoCapture | 映像キャプチャの停止 |
| setLocalView | ローカル映像コンテナーの設定 |
| setRemoteView | リモート映像コンテナーの設定 |
映像エンコード設定
| API | 説明 |
|---|---|
| setVideoEncoderConfig | 映像エンコードパラメーターの設定 |
| setVideoDecoderConfig | 映像デコードパラメーターの設定 |
メディアストリームの送信制御
| API | 説明 |
|---|---|
| enableSendMediaStream | メディアストリーム送信の有効化と無効化 |
リアルタイムメッセージ
| API | 説明 |
|---|---|
| sendDataMsg | データメッセージの送信 |
イベントコールバック
| API | 説明 |
|---|---|
| onError | エラーコールバック |
| onWarning | 警告コールバック |
| onConnectionStatusChange | 接続状態の変更 |
| onStats | 統計情報 |
| onAudioDeviceStateChanged | 音声デバイスの状態変更 |
| onAudioDeviceRouteChanged | 音声ルートの変更 |
| onAudioFileState | 予約済み音声ファイル状態イベント。現在は発生しません |
| onLocalAudioVolumeIndication | ローカル音量通知 |
| onVideoDeviceStateChanged | 映像デバイスの状態変更 |
| onDataMsg | データメッセージ |
API 詳細
エンジンのライフサイクル
createEngine
シングルトンのエンジンを作成します。繰り返し呼び出すと既存のインスタンスを返します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqCreateConfig | エンジン作成設定 |
AoqClientEngine インスタンス、失敗時は null を返します。
初期化済みのシングルトンには設定を再適用しません。新しい設定で作成するには、既存のエンジンを破棄してください。
createAoqClientEngine
パッケージがエクスポートする名前付きファクトリーで、AoqClientEngine.createEngine(config) と同等です。インスタンスメソッドではなく、追加の初期化も不要です。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqCreateConfig | 必須。{} も有効です。繰り返し作成しても設定は再適用されません。 |
null を返します。
destroy
エンジンを破棄し、リソース解放を開始して、すべてのイベントリスナーを削除します。
0、インスタンスがない場合は AoqECStateInvalid(2) を返します。
このメソッドは同期的に戻ります。ログ保存や任意のダンプ出力はバックグラウンドで非同期実行され、戻った時点で未完了の場合があります。SDK を再使用するには createEngine で作成し直してください。破棄済みインスタンスは再使用できません。
getVersion
SDK のバージョンを取得します。
isAoqSupported
AOQ 接続に必要なブラウザーの基本機能を確認します。
Promise<AoqSupportResult> を返します。
Worker 内で WebTransport を検査し、タイムアウトは 5 秒です。ネットワーク到達性、サーバー設定、認証、デバイス権限、個別のメディア設定は検査しません。supported: true は接続や通話の成功を保証しません。
connect
サーバーへの接続を開始します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqConnectConfig | トークン、セッション ID、Relay エンドポイントなどの接続認証情報 |
0 を返します。
エンジン作成、イベント登録、コーデック設定の後に呼び出します。通常は Disconnected から接続し、Failed からの再試行も可能です。それ以外の状態では AoqECStateInvalid(2) を返します。無効なトラック、メディア、接続設定、または必要な WebCodecs 機能なしでの Opus 選択は AoqECParamInvalid(1) になる場合があります。Network Worker が利用できない場合は AoqECStateInvalid(2) を返します。
結果は onConnectionStatusChange で非同期通知されます。Connected は MEDIA_SETUP が完了し、メディアトラックがバインドされた状態です。モデルのデータプロトコルに従ってセッションを設定し、アプリケーションの準備完了を確認してから音声や映像の送信を有効にしてください。
disconnect
サーバーとの接続を切断します。
0 を返します。
結果は onConnectionStatusChange で通知されます。AoqConnectionStatusDisconnected を待ってからコーデック設定を変更し、再接続してください。切断済みの場合は AoqECStateInvalid(2) を返します。切断してもデバイスは停止しないため、通話終了時はキャプチャと再生の停止メソッドも呼び出してください。
音声デバイスの管理
startAudioCapture
マイクのキャプチャを開始し、デバイス権限を非同期で要求します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqAudioCaptureConfig | 音声キャプチャ設定 |
Promise<number> を返します。0 は成功です。
初回または未許可の場合、ブラウザーがマイク権限を要求することがあります。キャプチャ状態は onAudioDeviceStateChanged で通知されます。
輻輳時、送信キューで約 100 ms 待機した上り音声は、遅延の蓄積を防ぐため破棄されます。送信開始済みの音声は取り消しません。この値はエンドツーエンド遅延の上限ではありません。
stopAudioCapture
音声キャプチャを停止します。
0 を返します。
デバイスが未起動または停止済みの場合、AoqECStateInvalid(2) を返します。
muteAudioCapture
音声キャプチャをミュートまたは解除します。ミュート中もキャプチャは続きますが、無音フレームを送信します。
| パラメーター | 型 | 説明 |
|---|---|---|
mute | boolean | true:ミュート、false:解除 |
0 を返します。
startAudioPlayer
音声プレーヤーを開始し、出力デバイスを非同期で初期化します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqAudioPlaybackConfig | 音声再生設定 |
Promise<number> を返します。0 は成功です。
再生状態は onAudioDeviceStateChanged で通知されます。
ユーザーのクリックイベントから呼び出し、自動再生制限に対応してください。開始中または開始済みの場合は AoqECStateInvalid(2) を返します。
Realtime モード(下り音声の trackMode が Stream)では、プレーヤー開始前の受信音声も蓄積せず継続的に消費します。初回を含め毎回の開始で以前の音声を消去し、新規受信分から再生します。Segment モードは未再生分を保持します。
stopAudioPlayer
音声プレーヤーを停止します。
0 を返します。
デバイスが未起動または停止済みの場合、AoqECStateInvalid(2) を返します。
Realtime モードでは出力停止後も受信音声の消費と映像再生が続きます。再開時は新しい音声のみ再生します。一時停止や中断状態は再起動後も保持されます。Segment モードは未再生分を保持します。
pauseAudioPlayer
フェードアウト後に再生を一時停止します。再開には resumeAudioPlayer を呼び出します。
| パラメーター | 型 | 説明 |
|---|---|---|
fadeMs | number | フェードアウト時間(ms)。実デバイスのサンプルレートでサンプル数に丸めます。0 は無効化、負数や非有限値は 100 ms を使用します。 |
0 を返します。フェードアウトは未完了の場合があり、プレーヤーが再生中であることも保証しません。
Segment モードは未再生音声と読み取り位置を保持して、その位置から再開します。Realtime モードは待機音声を破棄し、停止中も受信分を消費して現在のリアルタイム位置から再開します。一時停止中の音声は再生しません。
resumeAudioPlayer
一時停止または中断した再生をデフォルトのフェードインで再開します。Segment は 2 ms、Realtime は 100 ms です。
| パラメーター | 型 | 説明 |
|---|---|---|
fadeMs | number | 予約済みで、現在は指定時間を無視します。デフォルトのフェードインを使用し、0 でも無効化できません。 |
0 を返します。再開処理は未完了の場合があります。
interruptAudioPlayer
再生を中断し、フェードアウト後に残りの未再生音声を破棄します。Segment の一時停止とは異なり、再開しても破棄分は再生しません。
| パラメーター | 型 | 説明 |
|---|---|---|
trackType | AoqTrackType | 互換性パラメーター。Audio を指定してください。現在はこの値で再生ストリームを選択しません。 |
fadeMs | number | フェードアウト時間(ms)。実デバイスのサンプルレートでサンプル数に丸めます。0 は無効化、負数や非有限値は 100 ms を使用します。 |
0 を返します。中断は未完了の場合があり、プレーヤーが再生中であることも保証しません。
サーバーが次のラウンドの音声を送信すると自動再開します。resumeAudioPlayer でも再開できます。
一時停止中の中断要求は無視されますが、0 を返す場合があります。その後 Segment は停止前の残りを再生します。一時停止から中断する手順で再生キューは消去できません。
音声エンコード設定
setAudioEncoderConfig
音声エンコードパラメーターを設定します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqAudioCodecConfig | 音声エンコード設定 |
0 を返します。
connect() 前、エンジンが Disconnected のときに呼び出します。接続処理中や接続済みでは AoqECStateInvalid(2) を返します。切断して Disconnected を待ち、設定してから再接続してください。
0 は設定要求の受理を表します。音声形式は接続時に再検証されます。Opus にはブラウザーの WebCodecs 対応も必要です。
setAudioDecoderConfig
音声デコードパラメーターを設定します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqAudioCodecConfig | 音声デコード設定 |
0 を返します。
connect() 前、エンジンが Disconnected のときに呼び出します。接続処理中や接続済みでは AoqECStateInvalid(2) を返します。
ローカル音量通知
enableLocalAudioVolumeIndication
onLocalAudioVolumeIndication によるローカルキャプチャ音量の定期通知を有効化または無効化します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqAudioVolumeIndicationConfig | 音量通知設定 |
0 を返します。
interval を 0 または負数にするとコールバックを無効化します。
映像デバイスの管理
startVideoCapture
カメラのキャプチャを開始します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqVideoCaptureConfig | 映像キャプチャ設定 |
0 を返します。
0 は非同期キャプチャ要求の受理を表します。成否は onVideoDeviceStateChanged で通知され、カメラが起動済みとは限りません。
cameraPreference は向きの列挙値またはデバイス ID を指定します。省略時はブラウザーが選択します。要求を満たせない場合、別の使用可能なカメラにフォールバックできます。
getCameras
videoinput を列挙します。カメラを開いたり権限を要求したりしません。許可前は名前や ID が不完全な場合があります。許可後やデバイス変更後に再列挙できます。未初期化または列挙失敗時は Promise が拒否されます。
switchCamera
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
cameraPreference | AoqCameraDirection | string | いいえ | 向きまたはデバイス ID の優先設定。省略すると以前の設定を消去し、ブラウザーが再選択します。 |
0 は受理を表し、状態は onVideoDeviceStateChanged、失敗は onError で通知します。未キャプチャ、開始中、切り替え中は AoqECStateInvalid(2)、無効な向きや空白 ID は AoqECParamInvalid(1) を返します。
切り替えは旧デバイスを解放し、対象を開いて初回フレームを待ちます。旧トラックが Worker に移管された場合(後でメインスレッドに戻った場合も含む)、解放確認を最大 2 秒待ちます。確認タイムアウトでは対象を開かず復旧も行わず失敗を報告します。各試行は最大 15 秒です。失敗時は元のデバイス設定で一度復旧を試み、復旧成功でも切り替え失敗を報告します。成功時は CaptureStarted(reason=0)、失敗して復旧済みなら CaptureStarted(reason=エラーコード)、復旧不可なら CaptureFail(reason=エラーコード) です。明示対象がすでに満たされる場合は再オープンせず非同期で CaptureStarted を通知します。実デバイス ID は通知しません。送信スイッチ、コーデック設定、プレビューバインドは維持します。キャプチャ停止で切り替えを中止でき、破棄後は通知しません。
切り替え時に映像が短時間途切れる場合があります。キャプチャの時間軸は連続しますが、ハードウェアレベルの音声・映像同期は保証しません。実デバイスはブラウザーが選択するため、要求した設定を選択済みデバイスとして UI に表示しないでください。
stopVideoCapture
映像キャプチャを停止します。
0 を返します。
デバイスが未起動または停止済みの場合、AoqECStateInvalid(2) を返します。
setLocalView
ローカル映像コンテナーを設定します。SDK は内部に描画要素を作成します。
| パラメーター | 型 | 説明 |
|---|---|---|
trackType | AoqTrackType | AoqTrackTypeVideo のみ対応します。他の型は AoqECUnSupport(3) を返します。 |
canvas | AoqVideoCanvas | null | 描画コンテナー設定。null でバインドを解除します。 |
0 を返します。
コンテナーの寸法を明示してください。SDK は内部に描画要素を作成します。
寸法を明示した通常の DOM コンテナー(div など)を使用します。video、audio、canvas、img、空要素は直接指定できません。コンテナー、ID、renderMode が無効な場合は AoqECParamInvalid(1) を返し、以前のバインドを維持します。0 は受理を表し、初回フレームが描画済みとは限りません。
setRemoteView
リモート映像コンテナーを設定します。SDK は内部に描画要素を作成します。
| パラメーター | 型 | 説明 |
|---|---|---|
trackType | AoqTrackType | AoqTrackTypeVideo のみ対応します。他の型は AoqECUnSupport(3) を返します。 |
canvas | AoqVideoCanvas | null | 描画コンテナー設定。null でバインドを解除します。 |
0 を返します。
寸法を明示した通常の DOM コンテナー(div など)を使用します。video、audio、canvas、img、空要素は直接指定できません。コンテナー、ID、renderMode が無効な場合は AoqECParamInvalid(1) を返し、以前のバインドを維持します。0 は受理を表し、初回フレームが描画済みとは限りません。
映像エンコード設定
setVideoEncoderConfig
映像エンコードパラメーターを設定します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqVideoCodecConfig | 映像エンコード設定 |
0 を返します。
エンジンが Disconnected のときに呼び出します。接続処理中や接続済みでは AoqECStateInvalid(2) を返します。初回接続と映像キャプチャの前に設定してください。設定は統合・キャッシュされ、後続のストリーム確立に使われます。既存のキャプチャやエンコーダーは即時再設定されません。
setVideoDecoderConfig
映像デコードパラメーターを設定します。
| パラメーター | 型 | 説明 |
|---|---|---|
config | AoqVideoCodecConfig | 映像デコード設定 |
0 を返します。
connect() 前、エンジンが Disconnected のときに呼び出します。接続処理中や接続済みでは AoqECStateInvalid(2) を返します。
メディアストリームの送信制御
enableSendMediaStream
音声または映像トラックの送信を有効化または無効化します。
| パラメーター | 型 | 説明 |
|---|---|---|
trackType | AoqTrackType | メディアトラックの種類 |
enable | boolean | true:送信有効、false:送信無効 |
0 を返します。
Audio と Video のみ制御し、Data は対象外です。他の値は 0 を返しても効果がない場合があります。送信停止ではキャプチャデバイスを停止しないため、該当する stop...Capture() を呼び出してください。
リアルタイムメッセージ
sendDataMsg
Uint8Array に格納した UTF-8 テキスト(アプリケーションの JSON など)を相手側へ送信します。現在の WT 経路では任意のバイナリや SDK 内部制御メッセージは送信できません。
| パラメーター | 型 | 説明 |
|---|---|---|
msg | AoqDataMsg | メッセージオブジェクト。msg.data は空でない UTF-8 バイト列です |
0 を返します。
接続済みかつトラック準備済みで、publishTracks に Data が必要です。メッセージがない、または msg.data が Uint8Array でない場合は AoqECParamInvalid(1)、未準備なら AoqECStateInvalid(2) を返します。送信ストリームが無効またはメッセージが空なら現在は -1 を返します。0 はローカル受理で、相手側の受信確認ではありません。UTF-8 検証や後続送信で onError が発生する場合があります。
msg.data の元の ArrayBuffer は移管されて無効になる場合があり、共有する他のビューも影響を受けます。元データが必要なら data.slice() のコピーを渡してください。フロントエンドのメッセージやログで API キーや一時認証情報を送信しないでください。
イベントコールバック
engine.on('eventName', callback) で購読し、engine.once(...) で一度だけ受信し、同じ関数参照の engine.off('eventName', callback) で解除します。破棄時に全リスナーを削除します。接続やデバイス開始の前に登録し、コールバックの処理を軽量にしてください。
| イベント | コールバックシグネチャ | 説明 |
|---|---|---|
onError | (code: number, message: string) => void | エラーコールバック |
onWarning | (code: number, message: string) => void | 警告コールバック |
onConnectionStatusChange | (status: AoqConnectionStatus) => void | 接続状態の変更 |
onStats | (stats: AoqStats) => void | 統計情報 |
onAudioDeviceStateChanged | (state: AoqAudioDeviceState) => void | 音声デバイスの状態変更 |
onAudioDeviceRouteChanged | (routeType: AoqAudioDeviceRouteType) => void | 音声ルートの変更 |
onAudioFileState | (state: AoqAudioFileState) => void | 予約済み。現在は発生しません |
onLocalAudioVolumeIndication | (volume: AoqAudioVolume) => void | ローカル音量通知 |
onVideoDeviceStateChanged | (state: AoqVideoDeviceState) => void | 映像デバイスの状態変更 |
onDataMsg | (msg: AoqDataMsg) => void | データメッセージ |
onError
同期戻り値以外の非同期エラーや実行時エラーを報告します。code と message、接続・デバイス状態を併せて診断してください。エラーが接続全体の終了を意味するとは限りません。ネットワークエラーが汎用状態コードを使う場合もあり、数値だけで発生段階を判定しないでください。
| パラメーター | 型 | 説明 |
|---|---|---|
code | number | エラーコード。AoqErrorCode を参照 |
message | string | エラーの説明 |
onWarning
注意が必要な致命的でない状態をエンジンの警告として通知します。
| パラメーター | 型 | 説明 |
|---|---|---|
code | number | 警告コード。AoqWarningCode を参照 |
message | string | 警告の説明 |
onConnectionStatusChange
接続状態の変更を通知します。
| パラメーター | 型 | 説明 |
|---|---|---|
status | AoqConnectionStatus | 現在の接続状態 |
onStats
Connected 中は約 1 秒ごとに統計を通知し、その状態を離れると停止します。フィールドの対応状況は AoqStats を参照してください。プレースホルダー値は測定値ではありません。
| パラメーター | 型 | 説明 |
|---|---|---|
stats | AoqStats | 統計情報オブジェクト |
onAudioDeviceStateChanged
音声のキャプチャ・再生デバイスの操作状態変更を通知します。
| パラメーター | 型 | 説明 |
|---|---|---|
state | AoqAudioDeviceState | 音声デバイスの状態 |
onAudioDeviceRouteChanged
出力デバイス一覧の変更時に、ブラウザーのラベルからルート種別を推定します。誤判定や通知漏れがあり、実際の出力ルートの確認にはなりません。許可前や情報不足ではデフォルト値を返す場合があります。
| パラメーター | 型 | 説明 |
|---|---|---|
routeType | AoqAudioDeviceRouteType | ラベルから推定したルートであり、実際の出力デバイスの確認ではありません |
onAudioFileState
予約済みの音声ファイル状態コールバック。現在の AoqClientEngine にファイル再生制御はなく、このイベントも発生しません。
| パラメーター | 型 | 説明 |
|---|---|---|
state | AoqAudioFileState | 音声ファイルの状態 |
onLocalAudioVolumeIndication
ローカルキャプチャ音量を通知します。先に enableLocalAudioVolumeIndication で有効化してください。
| パラメーター | 型 | 説明 |
|---|---|---|
volume | AoqAudioVolume | 音量情報 |
onVideoDeviceStateChanged
映像キャプチャデバイスの操作状態変更を通知します。
| パラメーター | 型 | 説明 |
|---|---|---|
state | AoqVideoDeviceState | 映像デバイスの状態 |
onDataMsg
受信したデータメッセージを通知します。
| パラメーター | 型 | 説明 |
|---|---|---|
msg | AoqDataMsg | 受信メッセージオブジェクト。TextDecoder で msg.data の UTF-8 テキストを読み取ります。 |
subscribeTracks に Data を含めます。コールバックの引数はオブジェクトであり、Uint8Array そのものではありません。業務 JSON の解析と検証はアプリケーションで行います。
データ型と列挙型
共通の型
AoqCreateConfig
エンジン作成設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
workDir | string | いいえ | — | 予約済み。Web SDK はこの値で保存ディレクトリを指定しません |
enableDumpAudio | boolean | いいえ | false | 音声デバッグデータを保存します。ユーザー音声の許可を取得し、アクセスを制御してください。 |
enableDumpExport | boolean | いいえ | false | enableDumpAudio=true の場合のみ有効。破棄時にダンプ ZIP を非同期で出力し、該当 OPFS ファイルを削除します。 |
maxEncodedVideoFrameBytes | number | いいえ | 194560 (190×1024) | JPEG 単一フレームの目標上限(バイト)。0 は無効化。超過時は画質を下げ、無効値はデフォルトを使います。 |
enableDropOversizedVideoFrame | boolean | いいえ | false | 最低 JPEG 品質でも超過する場合に破棄するか。false では超過フレームを送信する場合があります。上限 0 ではこの理由で破棄しません。 |
extras | string | いいえ | — | JSON オブジェクト文字列。無効な JSON、非オブジェクト値、無効なリモート描画方針では createEngine が null を返します。 |
extras フィールド:
| JSON フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
remoteVideoRenderer | 'auto' | 'video' | 'canvas' | 'auto' | リモート描画方針。auto は video を優先し、必要に応じて canvas に切り替えます。 |
user_specified_enable_av_sync | boolean | true | 音声・映像同期を有効にするか。JSON の真偽値を使用してください。 |
user_specified_audio_playback_transport | 'message-port' | 自動 | MessagePort 再生を指定します。省略時は環境により共有メモリか MessagePort を選択します。 |
AoqConnectConfig
接続認証設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
token | string | はい | — | aoqTokenForClient に対応する空でない一時クライアントトークン。API キーではありません |
sid | string | はい | — | 空でないセッション ID。認証応答の完全な sid 文字列を使います。 |
wtBaseUrl | string | いいえ | Relay から構成 | 単一路線で優先する HTTPS WT URL。複数ルートでは無視し、各ホスト・ポートの /aoq に接続します。 |
signedSid | string | はい(実行時) | — | 完全な署名済み SID。通常は認証応答の完全な sid。TypeScript では省略可能ですが、現在の WT 接続では必須です。 |
certFingerprint | string | string[] | 条件付き | — | 共通の WT 証明書 SHA-256 フィンガープリント。独自値のないルートで利用できる必要があります。 |
workspaceIdHash | string | いいえ | — | extraInfo.workspaceIdHash に対応します。元の Workspace ID で代用しないでください。 |
relayEndpoints | AoqRelayEndpoint[] | はい | — | 完全な接続先一覧。少なくとも 1 件必要です |
publishTracks | AoqTrackParam[] | はい | — | 上りトラック一覧。空でも構いませんが、subscribeTracks と同時に空にはできません。 |
subscribeTracks | AoqTrackParam[] | はい | — | 下りトラック一覧。空でも構いません。同一方向の重複と Screen は未対応です。 |
clientRelayEndpoints[].route_index を routeIndex に変換します。SID、接続先、ルート番号、フィンガープリントを独自に作成しないでください。
WT フィンガープリントは実際の WebTransport 接続先証明書と一致させます。sha256/<hex> は接頭辞を除き、64 桁の 16 進数を検証します。共通値もルート値も文字列または配列で指定でき、全要素が有効である必要があります。いずれか一致すれば検証に成功します。空でないルート値が共通値より優先され、空配列は未設定です。汎用フィンガープリントや検証を省略する設定はありません。
signedSid や有効なフィンガープリントがないと、connect() が 0 を返しても非同期接続に失敗する場合があります。状態イベントと onError を処理してください。
AoqRelayEndpoint
Relay エンドポイント。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
routeIndex | number | はい(実行時) | — | 0~2147483647 の一意な整数。初回は最小番号を選択します。TypeScript では省略可能です。 |
certFingerprint | string | string[] | 条件付き | 共通フィンガープリント | 空でないルート値が共通値を上書きします。共通フィンガープリントがない場合は必須です。 |
endpoint | string | はい | — | スキーム、パス、空白、ユーザー情報、クエリを含まない WT ホスト名/IP。IPv6 に対応します。 |
port | number | はい | — | WT ポート。1~65535 の整数 |
AoqTrackParam
トラック属性。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
trackType | AoqTrackType | はい | — | Audio、Video、Data。同一方向で重複不可。Screen は現在未対応です。 |
trackMode | AoqTrackMode | いいえ | 音声ダウンリンクは Segment | 音声下りのみを制御します。PCM / Opus の既定値は Segment、Stream を明示すると Realtime です。音声上りは常に Realtime。上り、映像、データでは無視します。 |
AoqSupportResult
ブラウザー機能の検査結果。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
supported | boolean | — | 環境に AOQ 接続の基本機能があるか |
missingFeatures | AoqMissingFeature[] | — | 検出された事前検査の失敗。'secure-context'、'worker'、'web-transport' を含む場合があります |
AoqMissingFeature
基本機能の検査失敗:'secure-context' | 'worker' | 'web-transport'。worker は Worker API 不在だけでなく、配置ポリシーの制限、起動・実行失敗、検査タイムアウトも示します。すべてのメディア機能を評価する一覧ではありません。
音声の型
AoqAudioCaptureConfig
音声キャプチャ設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
channel | number | いいえ | 1 | 要求するチャネル数。1(モノラル)/ 2(ステレオ)。実際の値はデバイストラック設定で決まる場合があります。 |
AoqAudioPlaybackConfig
音声再生設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
channel | number | いいえ | 1 | 要求する再生チャネル数。1 / 2。出力は実際の AudioContext サンプルレートを使用します。 |
playOnlyAndIgnoreMute | boolean | いいえ | false | 再生専用。ブラウザー対応時に audioSession を playback とし、iOS ミュートスイッチの影響を回避します。マイクも使う場合は false のままにしてください。未対応環境ではミュート無視は保証しません。 |
AoqAudioCodecConfig
音声コーデック設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
trackType | AoqTrackType | いいえ | — | 予約済み。現在は音声ストリーム選択には使いません |
codecType | AoqEncoderType | いいえ | AoqEncoderTypeAudioPCM | PCM / Opus。相手とネゴシエートした設定と一致させます。 |
sampleRate | number | いいえ | 48000 | サンプルレート(Hz)。ネゴシエーション対応値は 8000、12000、16000、24000、32000、44100、48000。個別のエンコードはブラウザー対応も必要です。 |
channel | number | いいえ | 1 | チャネル数。1 または 2 |
bitrate | number | いいえ | 32000 (Opus エンコード) | bps 単位。Opus エンコードのみ使用します。PCM はサンプルレート、チャネル数、ビット深度で決まります。デコードでは使いません。 |
AoqAudioVolumeIndicationConfig
ローカル音量通知設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
interval | number | いいえ | 0 | 通知間隔(ms)。<=0 は無効化、0 より大きく 10 未満なら 10 として扱います。 |
smooth | number | いいえ | 3 | 音量平滑化係数。0..10。大きいほど滑らかになります。 |
reportSpeech | boolean | いいえ | false | 音声活動(VAD)を通知するか |
AoqAudioVolume
ローカル音量情報。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
volume | number | — | 平滑化済みの瞬時音量。範囲 [0-255] |
isSpeech | boolean | — | 省略可能な音声活動フラグ。reportSpeech=true の場合のみ有意です。欠落を処理してください。 |
AoqAudioDeviceState
音声デバイス状態の通知データ。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
state | AoqAudioDeviceStateCode | — | 音声デバイス状態コード |
reason | number | — | 理由コード。AoqErrorCode を参照 |
AoqAudioFileState
予約済みの音声ファイル再生状態。現在の Web SDK では対応イベントは発生しません。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
fileId | string | — | 音声ファイル ID |
stateCode | AoqAudioFileStateCode | — | ファイル再生状態コード |
errorCode | number | — | エラーコード |
映像の型
AoqVideoCaptureConfig
映像キャプチャ設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
width | number | いいえ | 1280 | 要求キャプチャ幅(ピクセル、ideal 制約)。実際はブラウザー/デバイスが決定します。 |
height | number | いいえ | 720 | 要求キャプチャ高さ(ピクセル、ideal 制約)。実際はブラウザー/デバイスが決定します。 |
fps | number | いいえ | 15 | 要求キャプチャフレームレート。ideal と max 制約 |
cameraPreference | AoqCameraDirection | string | いいえ | ブラウザーが選択 | カメラの向きまたは ID の優先設定。ideal 制約でフォールバック可能。空白文字列は無効です。 |
AoqVideoCodecConfig
映像コーデック設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
trackType | AoqTrackType | いいえ | — | 予約済み。現在は映像ストリーム選択には使いません |
codecType | AoqEncoderType | いいえ | AoqEncoderTypeVideoH264 | H.264 / JPEG。相手とネゴシエートした設定と一致させます。 |
width | number | いいえ | 540 | エンコード目標幅/下りネゴシエーション幅(ピクセル)。接続時は正の整数が必要です。 |
height | number | いいえ | 960 | エンコード目標高さ/下りネゴシエーション高さ(ピクセル)。接続時は正の整数が必要です。 |
fps | number | いいえ | 5 | エンコード/下りネゴシエーションのフレームレート。接続時は正の整数が必要です。 |
bitrate | number | いいえ | 500000 (エンコード) | 正のエンコード目標ビットレート(bps)。デコードでは使いません。 |
minBitrate | number | いいえ | 128000 | 最低目標ビットレート(bps)。省略または 0 は 128000 とし、ユーザー目標以下に制限します。BWE 予算が 0 でも H.264 エンコードは停止しません。デコードでは使いません。 |
keyframeInterval | number | いいえ | 2 | H.264 キーフレーム間隔(秒)。エンコード時は最小 1 秒として扱います。JPEG/デコードでは使いません。 |
AoqVideoCanvas
映像描画コンテナー設定。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
view | HTMLElement | string | はい | — | 通常のコンテナー要素または DOM ID(# なし)。video、audio、canvas、img、空要素の直接指定は不可です。 |
renderMode | AoqRenderMode | いいえ | AoqRenderModeAuto(0) | 映像のフィット方式 |
AoqVideoDeviceState
映像デバイス状態の通知データ。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
state | AoqVideoDeviceStateCode | — | 映像デバイス状態コード |
reason | number | — | 理由コード。明示停止は 0、Web トラックの予期しない終了は AoqECVideoDevice(220) |
データメッセージの型
AoqDataMsg
公開 sendDataMsg / onDataMsg 共通の構造です。文字列や Uint8Array の直接指定は受け付けません。WT 経路ではバイト配列で UTF-8 テキストを運びます。
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
data | Uint8Array | はい | — | 送信時は空でない有効な UTF-8。受信時は msg.data を読み取ります。 |
統計情報の型
AoqStats
エンジン統計情報の概要。以下のフィールドは型定義上すべて省略可能です。欠落を処理してください。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
audioPublishStats | AoqAudioPublishStats[] | — | 音声送信の統計一覧 |
audioSubscribeStats | AoqAudioSubscribeStats[] | — | 音声受信の統計一覧 |
videoPublishStats | AoqVideoPublishStats[] | — | 映像送信の統計一覧 |
videoSubscribeStats | AoqVideoSubscribeStats[] | — | 映像受信の統計一覧 |
dataMsgPublishStats | AoqDataMsgPublishStats[] | — | データメッセージ送信の統計一覧 |
dataMsgSubscribeStats | AoqDataMsgSubscribeStats[] | — | データメッセージ受信の統計一覧 |
networkStats | AoqNetworkStats | — | ネットワーク統計 |
AoqAudioPublishStats
音声送信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | — | 接続全体の上りアプリケーションビットレート(bps)。音声単独ではありません |
bytes | number | — | 接続全体の上りアプリケーションバイト数。音声単独ではありません |
encodeVolume | number | 0 | プレースホルダー。音量は onLocalAudioVolumeIndication を使用してください。 |
AoqAudioSubscribeStats
音声受信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | — | 接続全体の下りアプリケーションビットレート(bps)。音声単独ではありません |
bytes | number | — | 接続全体の下りアプリケーションバイト数。音声単独ではありません |
playVolume | number | 0 | プレースホルダー。再生ミュートの判定には使えません |
AoqVideoPublishStats
映像送信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | 0 | プレースホルダー。映像単独のビットレートは現在未提供です |
bytes | number | 0 | プレースホルダー。映像単独のバイト数は現在未提供です |
encodeFps | number | — | エンコードフレームレート |
AoqVideoSubscribeStats
映像受信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | 0 | プレースホルダー。映像単独のビットレートは現在未提供です |
bytes | number | 0 | プレースホルダー。映像単独のバイト数は現在未提供です |
decodeFps | number | — | デコードフレームレート |
renderFps | number | — | 描画フレームレート |
AoqDataMsgPublishStats
データメッセージ送信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | — | 現在のビットレート(bps) |
bytes | number | — | 累積送信バイト数 |
AoqDataMsgSubscribeStats
データメッセージ受信の統計。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
trackType | AoqTrackType | — | トラックの種類 |
bitrate | number | — | 現在のビットレート(bps) |
bytes | number | — | 累積受信バイト数 |
AoqNetworkStats
ネットワーク統計。ビットレートは業務ペイロードの bit/s、累積量は同じ基準のバイト数です。プローブと転送プロトコルのオーバーヘッドは含みません。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
sendBitrate | number | — | 上りビットレート(bps) |
sendBytes | number | — | 累積上りバイト数 |
recvBitrate | number | — | 下りビットレート(bps) |
recvBytes | number | — | 累積下りバイト数 |
loss | number | — | 省略可能な上り損失率(0–1)。ブラウザーの QUIC 観測を優先し、なければ Relay Datagram 推定を使います。不明なら省略します。 |
rtt | number | — | 省略可能な往復時間(ms)。不明なら省略 |
bwe | number | — | Client→Relay の有効な業務送信予算(bps)、省略可能。不明または期限切れなら省略 |
audioReserveBps | number | — | 現在のエンコード音声のペイロード予約ビットレート(bps)、省略可能。RED 冗長性と転送オーバーヘッドを含まず、実音声トラフィックではありません。 |
列挙型
AoqTrackType
トラックのメディア種別。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqTrackTypeAudio | 0 | 音声 |
AoqTrackTypeVideo | 1 | 映像 |
AoqTrackTypeData | 2 | データメッセージ |
AoqTrackTypeScreen | 3 | 予約済み。現在の接続処理では未対応です |
AoqTrackMode
音声転送モード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqTrackModeSegment | 0 | Segment モード |
AoqTrackModeStream | 1 | Realtime ストリームモード |
AoqEncoderType
トラックのメディア形式。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqEncoderTypeUnknown | 0 | 不明 |
AoqEncoderTypeAudioPCM | 1 | PCM 音声 |
AoqEncoderTypeAudioOpus | 2 | Opus 音声 |
AoqEncoderTypeVideoH264 | 3 | H.264 映像 |
AoqEncoderTypeVideoJpeg | 4 | JPEG 映像 |
AoqEncoderTypeDataText | 5 | テキストデータ |
AoqConnectionStatus
エンジンの接続状態。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqConnectionStatusDisconnected | 0 | 切断済み |
AoqConnectionStatusConnecting | 1 | 接続中 |
AoqConnectionStatusConnected | 2 | 接続済み |
AoqConnectionStatusFailed | 3 | 接続失敗 |
AoqErrorCode
エラーコード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqECOK | 0 | 成功 |
AoqECParamInvalid | 1 | 無効なパラメーター |
AoqECStateInvalid | 2 | 無効な状態 |
AoqECUnSupport | 3 | 現在のプラットフォーム/モードでは未実装 |
AoqECAudio | 100 | 音声全般のエラー |
AoqECAudioExternalBufferFull | 110 | 外部音声バッファー満杯 |
AoqECAudioDevice | 120 | 音声デバイス全般のエラー |
AoqECAudioDeviceRecordingAuthFailed | 121 | マイク権限の拒否 |
AoqECAudioDeviceRecordingOccupied | 122 | マイク使用中 |
AoqECAudioDeviceRecordingBackgroundStart | 123 | バックグラウンドでキャプチャ開始 |
AoqECAudioDeviceRecordingStartFail | 124 | キャプチャ開始失敗 |
AoqECAudioDevicePlayoutOccupied | 125 | 再生デバイス使用中 |
AoqECAudioDevicePlayoutBackgroundStart | 126 | バックグラウンドで再生開始 |
AoqECAudioDevicePlayoutStartFail | 127 | 再生開始失敗 |
AoqECAudioDeviceEarpieceRequiresVoipMode | 128 | 受話口には VoIP モードが必要 |
AoqECVideo | 200 | 映像全般のエラー |
AoqECVideoExternalBufferFull | 210 | 外部映像バッファー満杯 |
AoqECVideoExternalCaptureNotEnabled | 211 | 外部映像キャプチャ未有効化 |
AoqECVideoExternalEncoderNotEnabled | 212 | 外部映像エンコーダー未有効化 |
AoqECVideoDevice | 220 | 映像デバイス全般のエラー |
AoqECVideoDeviceCameraOpenFail | 221 | カメラのオープン失敗 |
AoqECVideoDeviceCameraAuthFailed | 222 | カメラ権限の拒否 |
AoqECVideoDeviceCameraOccupied | 223 | カメラ使用中 |
AoqECVideoDeviceCameraRunningError | 224 | カメラ実行時エラー |
AoqECVideoCodec | 230 | 映像コーデック全般のエラー |
AoqECVideoCodecEncoderInitFail | 231 | 映像エンコーダー初期化失敗 |
AoqECVideoRender | 240 | 映像描画全般のエラー |
AoqECVideoRenderCreateFail | 241 | レンダラー作成失敗 |
AoqECVideoRenderDrawError | 242 | 描画エラー |
AoqWarningCode
警告コード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqWCOK | 0 | 正常 |
AoqWCAudio | 100 | 音声全般の警告 |
AoqWCAudioHowling | 101 | ハウリング検出 |
AoqWCAudioDevice | 120 | 音声デバイス全般の警告 |
AoqWCAudioDeviceMicEnumerateError | 121 | マイク列挙エラー |
AoqWCAudioDeviceMicStartTimeout | 122 | マイク開始タイムアウト |
AoqWCAudioDeviceRecordingError | 123 | キャプチャエラー |
AoqWCAudioDeviceSpeakerEnumerateError | 124 | スピーカー列挙エラー |
AoqWCAudioDeviceSpeakerStartTimeout | 125 | スピーカー開始タイムアウト |
AoqWCAudioDevicePlayoutError | 126 | 再生エラー |
AoqWCAudioDeviceSilentMode | 127 | デバイスがサイレントモード |
AoqWCVideo | 200 | 映像全般の警告 |
AoqWCVideoCameraEnumerateError | 201 | カメラ列挙エラー |
AoqWCVideoEncoderSwitched | 202 | 映像エンコーダー切り替え済み |
AoqWCVideoRenderDowngrade | 203 | 描画のフォールバック |
AoqAudioDeviceStateCode
音声デバイス状態コード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqAudioDeviceNone | 0 | 状態なし |
AoqAudioDeviceRecordStarting | 1 | キャプチャ開始中 |
AoqAudioDeviceRecordStarted | 2 | キャプチャ開始済み |
AoqAudioDeviceRecordStopping | 3 | キャプチャ停止中 |
AoqAudioDeviceRecordStopped | 4 | キャプチャ停止済み |
AoqAudioDeviceRecordFail | 5 | キャプチャ失敗 |
AoqAudioDevicePlayStarting | 6 | 再生開始中 |
AoqAudioDevicePlayStarted | 7 | 再生開始済み |
AoqAudioDevicePlayStopping | 8 | 再生停止中 |
AoqAudioDevicePlayStopped | 9 | 再生停止済み |
AoqAudioDevicePlayFail | 10 | 再生失敗 |
AoqAudioDeviceRouteType
音声デバイスのルート種別。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqAudioDeviceRouteDefault | 0 | デフォルトルート |
AoqAudioDeviceRouteHeadset | 1 | ヘッドセット |
AoqAudioDeviceRouteSpeakerPhone | 4 | 内蔵スピーカー |
AoqAudioDeviceRouteUsb | 5 | USB デバイス |
AoqAudioDeviceRouteBluetooth | 6 | Bluetooth デバイス |
AoqAudioFileStateCode
音声ファイル再生状態コード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqAudioFileNone | 0 | 状態なし |
AoqAudioFileStarted | 1 | 再生開始済み |
AoqAudioFileStopped | 2 | 再生停止済み |
AoqAudioFilePaused | 3 | 再生一時停止中 |
AoqAudioFileResumed | 4 | 再生再開済み |
AoqAudioFileEnded | 5 | 再生終了 |
AoqAudioFileBuffering | 6 | バッファリング中 |
AoqAudioFileBufferingEnd | 7 | バッファリング完了 |
AoqAudioFileFailed | 8 | 再生失敗 |
AoqCameraDirection
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqCameraDirectionFront | 0 | 前面カメラを優先 |
AoqCameraDirectionBack | 1 | 背面カメラを優先 |
AoqVideoDeviceStateCode
映像デバイス状態コード。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqVideoDeviceNone | 0 | 状態なし |
AoqVideoDeviceCaptureStarting | 1 | キャプチャ開始中 |
AoqVideoDeviceCaptureStarted | 2 | キャプチャ開始済み |
AoqVideoDeviceCaptureStopping | 3 | キャプチャ停止中 |
AoqVideoDeviceCaptureStopped | 4 | キャプチャ停止済み |
AoqVideoDeviceCaptureFail | 5 | キャプチャ失敗 |
AoqMirrorMode
予約済みミラーモード列挙型。現在の Web SDK には使用する設定や API がありません。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqMirrorModeDisabled | 0 | ミラー無効 |
AoqMirrorModeEnabled | 1 | ミラー有効 |
AoqOrientationMode
予約済み向きモード列挙型。現在の Web SDK には使用する設定や API がありません。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqOrientationModeAuto | 0 | 自動 |
AoqOrientationModePortrait | 1 | 縦向き |
AoqOrientationModeLandscape | 2 | 横向き |
AoqRenderMode
映像フィット方式。
| 列挙値 | 値 | 説明 |
|---|---|---|
AoqRenderModeAuto | 0 | デフォルト:縦横比を保って全体表示 |
AoqRenderModeStretch | 1 | コンテナー全体に引き伸ばす |
AoqRenderModeFill | 2 | 縦横比を保って全体表示。黒帯を許可 |
AoqRenderModeCrop | 3 | 縦横比を保って全体を埋め、超過部分を切り取る |
その他の公開宣言
IAoqEngineEvents は予約済みの onAudioFileState を含む 10 個のイベントコールバックシグネチャを定義します。イベント名で購読すると TypeScript の引数推論を利用できます。
以下の型や列挙型はエクスポートされていますが、現在の Web エンジンには対応する制御/監視 API がありません。他プラットフォームの同名宣言から Web 対応を推測しないでください。
| 分類 | 公開宣言 | 現在の対応範囲 |
|---|---|---|
| 音声ファイルのミキシング | AoqAudioFileMixConfig, AoqAudioFileState, AoqAudioFileStateCode | ファイル再生/ミキシング制御なし。ファイル状態イベントは発生しません |
| 外部音声とオブザーバー | AoqAudioExternalStreamConfig, AoqAudioExternalFrameMeta, AoqAudioObserverParams, AoqAudioSource, AoqAudioStreamDirection | 外部音声入力や音声フレームオブザーバー登録のメソッドはありません |
| 外部映像とオブザーバー | AoqExternalVideoFrameMeta, AoqExternalVideoEncodedFrameMeta, AoqVideoObserverParams, AoqVideoSource, AoqVideoPixelFormat, AoqVideoObserverAlignment, AoqVideoCodecType | 外部映像フレーム入力や映像フレームオブザーバー登録はありません。コーデック設定は AoqEncoderType を使います。 |
| ミラーと向き | AoqMirrorMode, AoqOrientationMode | 対応する設定やメソッドはありません。ローカルプレビューのミラーは自動です。 |
| 低レベル音声デバイス | AoqAudioDeviceEvent, AudioDeviceApiError, AudioDeviceErrorCode | 低レベルデバイスの宣言であり、エンジンの追加イベントや戻りコード全体の契約ではありません |
AOQ_TRACK_AUDIO と AOQ_TRACK_DATA は文字列定数 'aoq_track_audio' と 'aoq_track_data' です。接続やビューのトラック選択用ではありません。これらの API には AoqTrackType を使用してください。
エラーと警告の列挙型にはプラットフォーム共通の値が残っています。Web SDK がすべての値を生成するとは限りません。利用可否は本書のメソッドと呼び出し条件を参照してください。