Tips
This page has not been translated yet.
録音・録画ファイルのメタデータの活用
録音・録画機能では保存した録音・録画ファイルと対になるメタデータを提供しています。
メタデータからは録音・録画ファイルの詳しい情報を知ることができます。
メタデータは以下の方法で取得できます。
- GetRecordingSession API のレスポンスの files フィールドを参照する
- DeleteRecordingSession API のレスポンスの files フィールドを参照する
- クラウドストレージの録音・録画ファイルと同一の階層に保存された同名の json ファイルを参照する
メタデータは以下のような構造になっています。
{ id: string; name: string; path: string; status: "RECORDING" | "SUCCEEDED" | "FAILED"; errors: { detail: string; occurredAt: string; }[]; type: "AUDIO" | "VIDEO" | "AUDIO_AND_VIDEO"; mimeType: string; createdAt: string; codecs: string[]; duration: number; publisherId: string; originPublisher: { name?: string | undefined; id: string; }; publications: { id: string; publisherId: string; originPublisher: { name?: string | undefined; id: string; }; contentType: "AUDIO" | "VIDEO"; }[]; }
メタデータのフィールドの詳細について説明します。
キー名 | フィールドの詳細 |
---|---|
name | クラウドストレージにおけるファイル名 |
path | クラウドストレージにおけるパス |
status | 録音・録画ファイルの状態 |
errors | statusがFAILEDの場合の原因となったエラー |
type | ファイルに含まれるメディアの種類 |
mimeType | ファイルの種別 |
createdAt | ファイルが作られた日時。ISO 8601形式 |
codecs | ファイルに含まれるメディアのコーデックのリスト |
duration | ファイルの再生時間(ミリ秒) |
publisherId | このファイルの元になっているPublicationをforwardingしているSFU BotのID |
originPublisher | このファイルの元になっているPublicationをpublishしているMemberの情報 |
publications | このファイルの元になっているPublicationのリスト |
ステレオ音声の録音
録音・録画機能は、ステレオ音声にも対応しています。 ステレオ音声の録音を行う場合は、LocalAudioStream の作成時、および publish 時に以下のパラメーターの設定が必要となります。
- JavaScript SDKの例
const audio = await SkyWayStreamFactory.createMicrophoneAudioStream({ channelCount: 2, // 一部のブラウザにおいてエコーキャンセラーを有効にした状態でステレオ音声を取得するとモノラルになる問題があるため、エコーキャンセラーを無効にする echoCancellation: false, }); // publish時に、codecCapabilitiesにステレオ音声の設定を追加する const audioPublication = await me.publish(audio, { codecCapabilities: [ { mimeType: "audio/opus", parameters: { stereo: 1 } }, ], });
なお、 iOS SDK 、 Android SDK では、ステレオ音声の送信には対応していません。