2023-11-01

• 该版本下接口：
  • 当 HTTP 响应状态码 !=200 时，表示调用失败。你可以根据返回结构中 BaseResponse.ResponseMetaData 的 Code 和 Message 字段解析错误原因。
  • 当 HTTP 响应状态码 ==200 时，表示调用成功。
• 若任务运行中，重复调用开始接口进行相同审核操作，如指定相同用户或指定重复审核类型，不会导致请求失败，BaseResponse.Result 会提示 The task has been started. Please do not call the startup task interface repeatedly。

InternalError.Parallel 变更为 InternalError.Redis。

2023-11-01

该版本下接口：

• 当 HTTP 响应状态码 !=200 时，表示调用失败。你可以根据返回结构中 BaseResponse.ResponseMetaData 的 Code 和 Message 字段解析错误原因。
• 当 HTTP 响应状态码 ==200 时，表示调用成功。

• InternalError.UnmarshalFail 变更为 InternalError.Unmarshal。
• InternalError.RPCError 变更为 InternalError.RPC。
• UnknownUser错误码废弃，不再返回错误，BaseResponse.Result 会提示 User is not found.
• 调用 BanRoomUser 时，若用户已被封禁，不再返回错误，BaseResponse.Result 会提示 User has been banned.
• 调用 BanRoomUser 时，若房间已被封禁，不再返回错误，BaseResponse.Result 会提示 Room has been banned.
• 调用 BanRoomUser 时，若房间未找到，不再返回错误，BaseResponse.Result 会提示 Room is not found.
• 调用 BanRoomUser 时，若用户已被封禁，不再返回错误，BaseResponse.Result 会提示 Room has been banned.
• 调用 UpdateBanRoomUserRule 时，若房间未被封禁，不再返回错误，BaseResponse.Result 会提示 Room is not banned.
• 调用 UpdateBanRoomUserRule 时，若用户未被封禁，不再返回错误，BaseResponse.Result 会提示 User is not banned.
• 新增 MissingParameter.NoRoomId 错误码。
• 新增 MissingParameter.NoUserId 错误码。
• 新增 MissingParameter.NoToken 错误码。
• 新增 MissingParameter.NoAppId 错误码。
• 新增 InvalidParameter.Forbidden 错误码。

2023-11-01

• 该版本下云端媒体处理接口：
  • 当 HTTP 响应状态码 !=200 时，表示调用失败。你可以根据返回结构中 BaseResponse.ResponseMetaData 的 Code 和 Message 字段解析错误原因。
  • 当 HTTP 响应状态码 ==200 时，表示调用成功。
• 若任务运行中，使用相同的 TaskId 重复调用开始接口不会导致请求失败，BaseResponse.Result 会提示 The task has been started. Please do not call the startup task interface repeatedly。
• 移除填写参数值不合法时自动调整为默认值逻辑。
• 调用UpdatePushMixedStreamToCDN 或 UpdateRecord时，若查不到正在运行的任务，会返回InvalidParameter.ErrorActiveTaskNotFound 错误。

2023-11-01

• 该版本下公共流接口：
  • 当 HTTP 响应状态码 !=200 时，表示调用失败。你可以根据返回结构中 BaseResponse.ResponseMetaData 的 Code 和 Message 字段解析错误原因。
  • 当 HTTP 响应状态码 ==200 时，表示调用成功。
• 移除填写参数值不合法时自动调整为默认值逻辑。

2023-11-01

2023-11-01

2023-11-01 版本下 OpenAPI 返回结构进行了优化，细节如下：

• 当 HTTP 响应状态码 !=200 时，表示调用失败。你可以根据返回结构中 BaseResponse.ResponseMetaData 的 Code 和 Message 字段解析错误原因。
• 当 HTTP 响应状态码 ==200 时，表示调用成功。

2020-12-01

流处理模式为转封装时，新增支持原视频编码方式为 ByteVC1。

2020-12-01

废弃 GetUserStreamState 接口，请使用音视频流状态变化相关回调来获取用户的实时推流状态。

2020-12-01

2023-07-20

2023-06-01

• 支持 Layout.CustomLayout.region 宽高设置绝对值像素。
• 支持设置 SEI 信息的 PayLoadType
• 支持传入 SEI Message
• 支持开启合流 SEI 音量提示

若返回的一级错误码为 InvalidParamter, http 响应状态码为 400。

2020-12-01

支持开启合流 SEI 音量提示

自定义布局下，支持最多将 30 路流合为一路流进行转推。

Control.VolumeIndicationInterval 参数类型变为 Float32，取值范围由[1,∞] 变为[0.3,∞]。

2023-06-01

• 支持 Layout.CustomLayout.region 宽高设置绝对值像素。

• 若返回的一级错误码是 InvalidParamter, http 响应状态码为 400。

2020-12-01

• StartPushPublicStream 接口新增 TranscodeMode 请求参数，支持设置公共流处理模式。
• UpdatePublicStreamParam 接口新增 TranscodeMode 请求参数，支持更新公共流处理模式。
• Control 字段新增 UserCaptureStatsMode 参数，支持开启房间用户采集状态回调。
• Control 字段新增 UserCaptureStatsInterval 参数，支持设置房间用户采集状态回调间隔。
• Control 字段新增 StreamPublishStatsMode 参数，支持开启房间用户发布状态回调。
• Control 字段新增 StreamPublishStatsInterval 参数，支持设置房间用户发布状态回调间隔。

2023-08-01

2020-12-01

TranscodeStateChanged 回调 TaskState 字段新增枚举值 4，表示当前推流地址已切换。

• UpdatePushMixedStreamToCDN 接口新增 IsUpdatePartialParam 请求参数，支持合流转推参数部分更新。
• UpdatePushMixedStreamToCDN 接口新增 SequenceNumber 请求参数，支持为更新请求添加序列号，确保服务端按照最新配置更新合流转推接口。
• GetPushSingleStreamToCDNTask 接口新增 PushStreamState 返回参数，支持查询推流状态。
• GetPushMixedStreamToCDNTask 接口新增 PushStreamState 返回参数，支持查询推流状态。

2020-12-01

新增 Layout.CustomLayout.Regions.Region.ApplySpatialAudio 参数，支持设置该路流对应用户是否开启空间音频效果。

2020-12-01

进房互踢行为优化，详情查看用户进退房回调说明

2020-12-01

回调新增 AudioSegmentInfo,音频审核时返回音频切片信息。

2020-12-01

2020-12-01

合流转推与单流转推接口支持 Layout.CustomLayout.Regions.Region 字段传空。

新增 Layout.CustomLayout.Regions.Region.MediaType 参数，支持设置单个用户流的媒体类型。
新增 Layout.CustomLayout.Regions.Region.AlternateImageRenderMode参数，支持补位图独立设置渲染模式。

2020-12-01

新增 Layout.CustomLayout.Regions.Region.MediaType 参数，支持设置单个用户流的媒体类型。
新增 Layout.CustomLayout.Regions.Region.AlternateImageRenderMode 参数，支持补位图独立设置渲染模式。

录制切片规则发生变化，详情请参看录制切片规则

2022-06-01

新增 Layout.CustomLayout.Regions.Region.MediaType 参数，支持设置单个用户流的媒体类型。
新增 Layout.CustomLayout.Regions.Region.AlternateImageRenderMode 参数，支持补位图独立设置渲染模式。

录制切片规则发生变化，详情请参看录制切片规则

2020-12-01

页面转推功能更名为云录屏，原云录屏功能下线。

2020-12-01

废弃 KickUser 接口，请使用 BanRoomUser 接口移除指定用户。
废弃 DismissRoom 接口，请使用 BanRoomUser 接口解散房间。

2020-12-01

2022-06-01

2022-06-01

2020-12-01

2020-12-01

• 开始合流转推接口名由 StartTranscode 变为 StartPushMixedStreamToCDN。
• 更新合流转推接口名由 UpdateTranscode 变为 UpdatePushMixedStreamToCDN。

2020-12-01

新增支持房间维度审核。详情可参看StartDetection.UserId。

2020-12-01

StreamControl.FrameRate 取值范围由[1,60] 变为[1,30]。

2020-12-01

新增 VideoConfig.VideoCodec参数，支持 H.264 和 VP8编码协议。

2020-12-01

2022-06-01

云端录制支持音视频模式录制下生成纯音频文件，即 Control.MediaType = 0 , FileFormatConfig= MP3、AAC 或 M4A时，可以生成纯音频文件。

2020-12-01

废弃 ListRooms 接口，请使用 ListRoomInfo 接口查询一段时间内，某个应用下进行音视频通话的房间列表及房间相关信息。
废弃 ListUsers 接口，请使用 ListUserInfo 接口查询一段时间内，某个应用下进行音视频通话的指定房间内特定或全部用户信息。

2020-12-01

新增支持设置布局的边框圆角半径。详情可参看Region。

2022-06-01

• 新增 S3 存储平台。
  新增支持存储平台包括：
  • 华为云 OBS
  • 腾讯云 COS
  • 七牛云 Kodo
    详情可参看 Config
• 新增 VeImageX 储存平台
  详情可参看StorageConfig

2022-06-01

新增 S3 存储平台。

新增支持存储平台包括：

• 华为云 OBS
• 腾讯云 COS
• 七牛云 Kodo
  详情可参看CustomConfig

2022-06-01

新增 S3 存储平台。

新增支持存储平台包括：

• 华为云 OBS
• 腾讯云 COS
• 七牛云 Kodo
  详情可参看 CustomConfig

2020-12-01

支持在房间内无用户推流的场景下发起转推直播任务。详细参数可参看Control。

2020-12-01

获取离线质量数据支持查询 web 端指标数据。详细参数可参看ListQuality

2020-12-01

获取离线分布质量数据支持查询 web 端指标数据。详细参数可参看ListQualityDistribution

2020-12-01

废弃StopTranscode接口，请使用 StopPushStreamToCDN 接口结束转推任务。

2020-12-01&2022-06-01

2020-12-01

2020-12-01

2020-12-01

页面转推支持页面监控功能。详细参数可参看Monitor

2020-12-01

废弃ListRoomInformation接口，请使用 ListRoomInfo 接口进行查询。
废弃 ListUserInformation接口，请使用 ListUserInfo 接口进行查询。

2020-12-01

公共流支持发送房间内用户音量指示。详细参数可参看 Control

2022-06-01

截图生成文件新增支持 S3 存储。

目前支持的存储平台包括：

• 火山引擎对象存储 TOS
• Amazon S3
• 阿里云对象存储OSS

2022-06-01

切片生成文件新增支持 S3 存储。

目前支持的存储平台包括：

• 火山引擎对象存储 TOS
• Amazon S3
• 阿里云对象存储OSS

2020-12-01

2020-12-01

转推直播支持空间音频功能。

2020-12-01

音频切片支持屏幕共享流。

2020-12-01

2020-12-01

2020-12-01

2020-12-01

2020-12-01

2020-12-01

废弃ListConcurrentData接口，请使用 ListOperationData 接口进行查询。
废弃 ListIndicators接口，请使用 ListQuality 接口进行查询。

2022-06-01

新增录制文件格式设置，支持 MP4、HLS、FLV、MP3、 AAC、M4A 格式存储。

2020-12-01

废弃 ListIndicators接口，请使用 ListQuality 接口进行查询。

2020-12-01

2020-12-01

2020-12-01

2022-06-01

录制生成文件新增支持 S3 存储。

目前支持的存储平台包括：

• 火山引擎视频点播 VOD
• 火山引擎对象存储 TOS
• Amazon S3
• 阿里云对象存储OSS

2020-12-01

新增 Layout.MainVideoStream 参数

废弃 Layout.MainVideoStreamIndex 参数。

当前版本 MainVideoStreamIndex 依然可用，但我们强烈建议你使用 MainVideoStream 参数。
如果你同时指定了 MainVideoStream 和 MainVideoStreamIndex的值，此时只有 MainVideoStream生效。

垂直布局支持屏幕流。

2020-12-01

新增 Layout.MainVideoStream参数

废弃 Layout.MainVideoStreamIndex 参数。

当前版本 MainVideoStreamIndex 依然可用，但我们强烈建议你使用 MainVideoStream 参数。
如果你同时指定了 MainVideoStream 和 MainVideoStreamIndex的值，此时只有 MainVideoStream生效。

垂直布局支持屏幕流。