ApsaraVideo Live:クラウド録画

音声のみの単独録画

シナリオ：チャンネル myRoom には、userA、userB、userC の 3 人のユーザーがいます。userA と userB の音声ストリームを個別に録画し、userC は録画しません。また、M3U8 と MP3 の両方のファイルを生成します。

録画結果：録画ファイルは、指定された Object Storage Service (OSS) バケット my-bucket に保存されます。M3U8 形式のファイルは hls/{TaskId} パスに、MP3 形式のファイルは mp3/{TaskId} パスに保存されます。

パラメーター例：

{
  "AppId": "my-app-id", // ストリーミングに使用するAppId
  "ChannelId": "myRoom", // 録画するチャンネル
  "SubscribeParams": {
    "SubscribeUserIdList": [
      {
        "UserId": "userA", // 録画対象のユーザー
        "StreamType": 1 // 音声のみのストリームをサブスクライブ
      },
      {
        "UserId": "userB", // 録画対象のユーザー
        "StreamType": 1 // 音声のみのストリームをサブスクライブ
      }
    ]
  },
  "RecordParams": {
    "RecordMode": 0, // 単独録画モードを指定
    "StreamType": 1, // 音声のみの出力形式を指定
    "MaxFileDuration": 180 // ファイル分割の期間を 180 秒 (3 分) に設定
  },
  "StorageParams": {
    "StorageType": 1, // OSSへの保存を指定
    "FileInfo": [ // M3U8とMP3ファイルを生成し、それぞれ "hls" と "mp3" パス配下に保存
      {
        "Format": "HLS",
        "FilePathPrefix": [
          "hls"
        ]
      },
      {
        "Format": "MP3",
        "FilePathPrefix": [
          "mp3"
        ]
      }
    ],
    "OSSParams": {
      "OSSEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OSSBucket": "my-bucket"
    }
  },
  "NotifyUrl": "http://mytest/callback", // オプション：コールバックメッセージを受信するURL
  "NotifyAuthKey": "12345678abcdefghikj" // オプション：コールバックメッセージの認証キー
}

音声とビデオの単独録画

シナリオ：チャンネル myRoom には、userA、userB、userC の 3 人のユーザーがいます。userA と userB の音声およびビデオストリームを個別に録画し、userC は録画しません。また、M3U8 と MP4 の両方のファイルを生成します。

録画結果：ファイルは、指定された OSS バケット my-bucket に保存されます。M3U8 ファイルは hls/{TaskId} パスに、MP4 ファイルは mp4/{TaskId} パスに保存されます。

パラメーター例：

{
  "AppId": "my-app-id", // ストリーミングに使用するAppId
  "ChannelId": "myRoom", // 録画するチャンネル
  "SubscribeParams": {
    "SubscribeUserIdList": [
      {
        "UserId": "userA", // 録画対象のユーザー
        "StreamType": 0 // 音声とビデオのストリームをサブスクライブ
      },
      {
        "UserId": "userB", // 録画対象のユーザー
        "StreamType": 0 // 音声とビデオのストリームをサブスクライブ
      }
    ]
  },
  "RecordParams": {
    "RecordMode": 0, // 単独録画モードを指定
    "StreamType": 0, // 音声とビデオの出力形式を指定
    "MaxFileDuration": 180 // ファイル分割の期間を 180 秒 (3 分) に設定
  },
  "StorageParams": {
    "StorageType": 1, // OSSへの保存を指定
    "FileInfo": [ // M3U8とMP4ファイルを生成し、それぞれ "hls" と "mp4" パス配下に保存
      {
        "Format": "HLS",
        "FilePathPrefix": [
          "hls"
        ]
      },
      {
        "Format": "MP4",
        "FilePathPrefix": [
          "mp4"
        ]
      }
    ],
    "OSSParams": {
      "OSSEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OSSBucket": "my-bucket"
    }
  },
  "NotifyUrl": "http://mytest/callback", // オプション：コールバックメッセージを受信するURL
  "NotifyAuthKey": "12345678abcdefghikj" // オプション：コールバックメッセージの認証キー
}

音声のみの複合録画

シナリオ：チャンネル myRoom には、userA、userB、userC の 3 人のユーザーがいます。userA と userB の会話を 1 つの複合ストリームとして録画し、userC は録画しません。また、M3U8 と MP3 の両方のファイルを生成します。

録画結果：ファイルは、指定された OSS バケット my-bucket に保存されます。M3U8 ファイルは hls/{TaskId} パスに、MP3 ファイルは mp3/{TaskId} パスに保存されます。

パラメーター例：

{
  "AppId": "my-app-id", // ストリーミングに使用するAppId
  "ChannelId": "myRoom", // 録画するチャンネル
  "SubscribeParams": {
    "SubscribeUserIdList": [
      {
        "UserId": "userA", // 録画対象のユーザー
        "StreamType": 1 // 音声のみのストリームをサブスクライブ
      },
      {
        "UserId": "userB", // 録画対象のユーザー
        "StreamType": 1 // 音声のみのストリームをサブスクライブ
      }
    ]
  },
  "RecordParams": {
    "RecordMode": 1, // 複合録画モードを指定
    "StreamType": 1, // 音声のみの出力形式を指定
    "MaxFileDuration": 180 // ファイル分割の期間を 180 秒 (3 分) に設定
  },
  "StorageParams": {
    "StorageType": 1, // OSSへの保存を指定
    "FileInfo": [ // M3U8とMP3ファイルを生成し、それぞれ "hls" と "mp3" パス配下に保存
      {
        "Format": "HLS",
        "FilePathPrefix": [
          "hls"
        ]
      },
      {
        "Format": "MP3",
        "FilePathPrefix": [
          "mp3"
        ]
      }
    ],
    "OSSParams": {
      "OSSEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OSSBucket": "my-bucket"
    }
  },
  "MixTranscodeParams": {
    "AudioBitrate": 128, // 音声ビットレート
    "AudioChannels": 2, // 音声チャンネル数
    "AudioSampleRate": 44100 // サンプルレート
  },
  "NotifyUrl": "http://mytest/callback", // オプション：コールバックメッセージを受信するURL
  "NotifyAuthKey": "12345678abcdefghikj" // オプション：コールバックメッセージの認証キー
}

音声とビデオの複合録画

シナリオ：チャンネル myRoom には、userA、userB、userC の 3 人のユーザーがいます。userA と userB の音声およびカメラストリーム、そして userC の音声のみのストリームを録画します。また、M3U8 と MP4 の両方のファイルを生成します。

生成されるビデオでは、userA と userB のペインが次のように配置されます：

録画結果：ファイルは、指定された OSS バケット my-bucket に保存されます。M3U8 ファイルは hls/{TaskId} パスに、MP4 ファイルは mp4/{TaskId} パスに保存されます。

パラメーター例：

{
  "AppId": "my-app-id", // ストリーミングに使用するAppId
  "ChannelId": "myRoom", // 録画するチャンネル
  "SubscribeParams": {
    "SubscribeUserIdList": [
      {
        "UserId": "userA", // 録画対象のユーザー
        "StreamType": 0, // 音声とビデオのストリームをサブスクライブ
        "SourceType": 0 // カメラストリームをサブスクライブ
      },
      {
        "UserId": "userB", // 録画対象のユーザー
        "StreamType": 0, // 音声とビデオのストリームをサブスクライブ
        "SourceType": 0 // カメラストリームをサブスクライブ
      },
      {
        "UserId": "userC", // 録画対象のユーザー
        "StreamType": 1 // 音声のみのストリームをサブスクライブ
      }
    ]
  },
  "RecordParams": {
    "RecordMode": 1, // 複合録画モードを指定
    "StreamType": 0, // 音声とビデオの出力形式を指定
    "MaxFileDuration": 180 // ファイル分割の期間を 180 秒 (3 分) に設定
  },
  "StorageParams": {
    "StorageType": 1, // OSSへの保存を指定
    "FileInfo": [ // M3U8とMP4ファイルを生成し、それぞれ "hls" と "mp4" パス配下に保存
      {
        "Format": "HLS",
        "FilePathPrefix": [
          "hls"
        ]
      },
      {
        "Format": "MP4",
        "FilePathPrefix": [
          "mp4"
        ]
      }
    ],
    "OSSParams": {
      "OSSEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OSSBucket": "my-bucket"
    }
  },
  "MixTranscodeParams": {
    "AudioBitrate": 128,
    "AudioChannels": 2,
    "AudioSampleRate": 44100,
    "VideoCodec": "H.264",
    "VideoBitrate": 500,
    "VideoFramerate": 30,
    "VideoGop": 30,
    "VideoHeight": 480, // 生成されるビデオの高さ
    "VideoWidth": 640 // 生成されるビデオの幅
  },
  "MixLayoutParams": {
    "UserPanes": [
      {
        "userId": "userA",
        "sourceType": 0,
        "height": "1", // キャンバスの全高を占める
        "width": "0.5", // キャンバスの半分の幅を占める
        // ペインをキャンバスの左上隅に配置
        "x": "0",
        "y": "0"
      },
      {
        "userId": "userB",
        "sourceType": 0,
        "height": "1", // キャンバスの全高を占める
        "width": "0.5", // キャンバスの半分の幅を占める
        // ペインをキャンバスの水平方向の中間点から配置
        "x": "0.5",
        "y": "0"
      }
    ]
  },
  "NotifyUrl": "http://mytest/callback", // オプション：コールバックメッセージを受信するURL
  "NotifyAuthKey": "12345678abcdefghikj" // オプション：コールバックメッセージの認証キー
}