Tips

録音・録画ファイルのメタデータの活用

録音・録画機能では保存した録音・録画ファイルと対になるメタデータを提供しています。

メタデータからは録音・録画ファイルの詳しい情報を知ることができます。

メタデータは以下の方法で取得できます。

  • 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録音・録画ファイルの状態
errorsstatusが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 では、ステレオ音声の送信には対応していません。