批量创建频道
接口描述
接口URL
请求方式
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
appId
true
String
timestamp
true
Long
当前13位毫秒级时间戳,3分钟内有效
sign
true
String
请求体参数描述
channels
true
Array
channel参数描述
name
true
String
频道名称
channelPasswd
false
String
频道密码
courseId
false
String
课程号
receive
false
String
是否为接收转播频道,不填或者填其他值为发起转播频道(注:需要开启频道转播功能该参数才生效) Y:表示是 N:表示否
autoPlay
false
Integer
是否自动播放,默认1 (注意,如果该值为空,则该频道会使用全局的“功能开关设置”。 如果非空,则会使用频道的“功能开关设置”) 0:自动播放 1:手动播放
playerColor
false
String
播放器控制栏颜色,默认:#666666
scene
false
String
直播场景 alone:活动拍摄 ppt:三分屏 topclass:大班课 seminar:研讨会
categoryId
false
Integer
subAccount
false
String
子账号邮箱,填写时频道会创建在该子账号下(子账号不能被删除或者禁用),暂无法通过接口获取
示例
请求体json参数:
响应参数描述
code
Integer
status
String
响应状态文本信息
message
String
响应描述信息,当code为400或者500的时候,辅助描述错误原因
data
Object
Data参数描述
channels
Array
channel参数描述
channelId
String
直播频道号
userId
String
POLYV用户ID,和保利威官网一致,获取路径:官网->登录->直播(开发设置)
name
String
直播频道名称
publisher
String
主持人
description
String
直播频道描述
url
String
直播推流地址
stream
String
直播流名称
logoImage
String
播放器logo
logoOpacity
Float
Logo不透明度 1:表示完全不透明 0:表示完全透明
logoPosition
String
logo位置 tr1:左上 tr:右上 b1:左下 br:右下
logoHref
String
Logo的跳转链接
coverImage
String
播放前显示的封面图
coverHref
String
封面图的跳转链接
waitImage
String
等待推流时的显示图片
waitHref
String
等待推流时显示图片的跳转链接
cutoffImage
String
切断流时的显示图片
cutoffHref
String
切断流时显示图片的跳转链接
advertType
String
片头广告 NONE:无广告 IMAGE:图片 FLV:视频
advertDuration
Integer
广告时长(秒)
advertWidth
Integer
广告区域宽度(像素)
advertHeight
Integer
广告区域高度(像素)
advertImage
String
图片广告
advertHref
String
广告的跳转链接
advertFlvVid
String
视频广告ID
advertFlvUrl
String
视频广告链接
playerColor
String
播放器控制栏颜色,例如 #666666
autoPlay
Boolean
是否自动播放
warmUpFlv
String
暖场视频链接
passwdRestrict
Boolean
观看密码限制,需要输入观看密码才能播放流
passwdEncrypted
String
观看密码加密后的密文
isOnlyAudio
String
Y:音频模式 N:普通模式
isLowLatency
String
低延迟
channelLogoImage
String
频道图标
scene
String
直播场景 alone:活动拍摄 ppt:三分屏 topclass:大班课 seminar:研讨会
channelViewerPasswd
String
参与者密码
channelPasswd
String
频道密码
linkMicLimit
Integer
连麦人数,-1:使用账号连麦分数,0-16:代表连麦人数
streamType
String
直播方式
pureRtcEnabled
String
是否是纯rtc拉流 Y:是 N:否
type
String
频道类型 发起转播:transmit 接收转播:receive 普通频道:normal
cnAndEnLiveEnabled
String
中英文直播间开关 Y:开启 N:关闭
pushEnUrl
String
英文推流地址
currentTimeMillis
Long
当前时间戳(毫秒)
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
响应示例
系统全局错误说明详见全局错误说明
成功示例
异常示例
Last updated
Was this helpful?