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	録音・録画ファイルの状態
errors	statusがFAILEDの場合の原因となったエラー
type	ファイルに含まれるメディアの種類
mimeType	ファイルの種別
createdAt	ファイルが作られた日時。ISO 8601形式
codecs	ファイルに含まれるメディアのコーデックのリスト
duration	ファイルの再生時間(ミリ秒)
publisherId	このファイルの元になっているPublicationをforwardingしているSFU BotのID
originPublisher	このファイルの元になっているPublicationをpublishしているMemberの情報
publications	このファイルの元になっているPublicationのリスト