Sewise 直播服务器软件V12接口说明视频校园直播系统.docx
《Sewise 直播服务器软件V12接口说明视频校园直播系统.docx》由会员分享，可在线阅读，更多相关《Sewise 直播服务器软件V12接口说明视频校园直播系统.docx（18页珍藏版）》请在冰豆网上搜索。
Sewise直播服务器软件V12接口说明视频校园直播系统
Sewise直播服务器软件V1.2接口说明
视频校园直播系统
近期，有些高校的视频校园直播系统管理，在论坛上问，学校安装直播服务器软件接口技术问题，如输入源的管理（输入源的列表、怎么添加输入源、编辑和修改输入源等），今天小编把各位的问题整理了一下，并如何解决直播服务器软件V1.2版本的一些接口问题说明，大家一起来看看吧！
1用户信息
登录视频校园直播服务器，进入直播系统管理－－接口信息页面获取接口用户信息（AccessID）。
文档接口输入参数均需传递如下参数：
+输入参数+
参数
类型
说明
必填
time
string
unix时间戳（1个小时超时时限）
是
code
string
标识码（组合AccessID.time.do.sourceid后，md5加密）。
do即接口的do参数；sourceid参数是选填项，如接口路径中包含sourceid则必须组合。
注意参数组合顺序。
是
2输入源管理
2.1列出输入源列表
接口地址
/service/api/?
do=stream
输入参数
参数
类型
说明
必填
pagesize
int
分页大小默认30
否
page
int
当前分页
否
q
string
查询关键字
否
sourceid
string
8位的源id
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
record
array
直播节目源记录数组（详细见表2-2）
total_record
int
总记录数
pagesize
int
分页大小
total_page
int
总分页数
page
int
当前分页
表2-1
Recordarray输入源记录数组
name
string
流名称
status
string
状态（0：
未链接，1：
等待链接，2：
已链接）
sourceid
string
8位的输入源id
type
int
流协议（0：
UDP，1：
RTMP，2：
HTTP）
mode_type
string
推/拉流模式（0：
推流，1：
拉流）
dimension
int
分辨率
normal_bitrate
string
标称码率
encode_name
string
编辑器名称
encode_position
string
编辑器位置
actual_bitrate
int
实际码率
video_encode_format
string
视频编码格式
audio_encode_format
string
音频编码格式
ip
string
IP地址，HTTP输入源地址
port
string
端口号
app
string
应用名
stream
string
rtmp拉流时的流ID
create_time
string
创建时间
last_modify
string
最后修改时间
rtmp
string
基于rtmp协议的播放地址
http
string
基于http协议flv封装的播放地址
m3u8
string
基于hls协议的播放地址
rtsp
string
基于rtsp协议的播放地址
rtmppush
string
rtmp推流地址（该参数只有在type=1andmode_type=0时有值）
表2-2
2.2添加输入源
接口地址
/service/api/?
do=stream
输入参数
参数
类型
说明
必填
op
string
值为add
是
type
int
流协议（0：
UDP，1：
RTMP，2：
HTTP）
是
mode_type
int
推/拉流模式（0：
推流，1：
拉流）
是
ip
int
输入源网络IP地址
否
port
int
输入源网络端口
否
name
string
输入源名称
是
normal_bitrate
string
输入标称码率
是
encode_name
string
编码器名称'
否
encode_position
string
编码器位
否
app
string
应用名
否
stream
int
流ID
否
node_ip
string
推流时，指定的节点ip（只针对于组网时，master上rtmp推流模式有效）
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
sourceid
string
8位的输入源id
rtmp
string
基于rtmp协议的播放地址
http
string
基于http协议flv封装的播放地址
m3u8
string
基于hls协议的播放地址
rtsp
string
基于rtsp协议的播放地址
rtmppush
string
rtmp推流地址（只有在type=1andmode_type=0时有值）
表2-3
说明:
选择UDP时，mode_type模式参数只能传递1（即拉流）,传递IP地址、端口号、输入源名称、输入标称码率、编码器名称、编码器位置参数。
选择HTTP时，mode_type模式参数只能传递1（即拉流）、输入源IP地址、输入源名称、输入标称码率。
选择RTMP拉流模式时，传递应用名、流ID、输入源名称、输入标称码率、编码器名称、编码器位置参数。
选择RTMP推流模式时，传递输入源名称、输入标称码率、编码器名称、编码器位置参数。
2.3编辑输入源
接口地址
/service/api/?
do=stream
输入参数
参数
类型
说明
必填
op
string
值为update
是
sourceid
string
8位的输入源id
是
type
int
流协议（0：
UDP,1：
RTMP，2：
HTTP）
是
mode_type
int
推/拉流模式（0：
UDP，1：
RTMP）
是
ip
int
输入源网络IP地址
否
port
int
输入源网络端口
否
name
string
输入源名称
是
normal_bitrate
string
输入标称码率
是
encode_name
string
编码器名称'
否
encode_position
string
编码器位
否
app
string
应用名
否
stream
int
流ID
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表2-4
2.4修改输入源的状态
接口地址
/service/api/?
do=stream
输入参数
参数
类型
说明
必填
op
string
值为updatestatus
是
sourceid
string
8位的输入源id
是
status
int
两个值（0/1）。
0：
向服务器请求停止直播流的发布；1：
向服务器请求发布直播流
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表2-5
2.5删除输入源
接口地址
/service/api/?
do=stream
输入参数
参数
类型
说明
必填
op
string
值为delete
是
sourceid
string
8位的输入源id
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表2-6
3直播节目管理
3.1列出直播节目列表
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
pagesize
int
分页大小默认30
否
page
int
当前分页
否
q
string
查询关键字
否
programid
string
8位的节目id
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
record
array
直播节目记录数组（详见表3-2）
total_record
int
总记录数
pagesize
int
分页大小
total_page
int
总分页数
page
int
当前分页
表3-1
Recordarray直播节目记录数组
programid
string
8位的节目id
name
string
直播节目名称
status
int
节目是否发布,三个值（0/1/2）。
0：
不发布；1：
发布；2：
已结束
click
int
播放次数
is_shift
int
是否时移，两个值（0：
否，1：
是）
description
string
备注
create_time
string
创建时间
last_modify
string
最后修改时间
streams
array
直播节目包含的直播节目源记录数组（详见表3-3）
表3-2
streamsarray直播节目包含的输入源记录数组
name
string
直播节目源名称
status
string
状态（0：
未链接，1：
等待链接，2：
已链接）
sourceid
string
8位的输入源id
type
int
流协议（0：
UDP，1：
RTMP，2：
HTTP）
mode_type
string
推/拉流模式（0：
推流，1：
拉流）
dimension
int
分辨率
normal_bitrate
string
标称码率
encode_name
string
编辑器名称
encode_position
string
编辑器位置
actual_bitrate
int
实际码率
video_encode_format
string
视频编码格式
audio_encode_format
string
音频编码格式
ip
string
IP地址
port
string
端口号
app
string
应用名
stream
string
rtmp拉流时的流ID
create_time
string
创建时间
last_modify
string
最后修改时间
rtmp
string
rtmp地址
http
string
http地址
m3u8
string
m3u8地址
rtsp
string
rtsp地址
表3-3
3.2添加直播节目
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为add
是
name
string
直播节目名称
是
description
string
备注
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
programid
string
8位的节目id
表3-4
3.3修改直播节目
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为update
是
programid
string
8位的节目id
是
name
string
直播节目名称
否
is_shift
int
是否时移，两个值（0：
否，1：
是）
否
description
string
备注
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表3-5
3.4删除直播节目
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为delete
是
programid
string
8位的节目id
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表3-6
3.5关联直播节目与输入源
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为addstream
是
programid
string
8位的节目id
是
sourceid
string
8位的输入源id
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表3-7
3.6解除直播节目与输入源
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为deletestream
是
programid
string
8位的节目id
是
sourceid
string
8位的直播节目源id
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表3-8
3.7修改直播节目状态
接口地址
/service/api/?
do=liveprogram
输入参数
参数
类型
说明
必填
op
string
值为updatestatus
是
programid
string
8位的节目id
是
status
int
三个值（0/1/2）。
0：
停止节目的发布；1：
发布节目；2：
结束节目
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
表3-9
4hls时移播放
4.1获取时移播放地址
接口地址
/service/api/?
do=getTimeShiftLiveStream
输入参数
参数
类型
说明
必填
sourceid
string
8位的输入源id
是
datetime
string
14位的绝对时间（例如：
20120920100000）
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
url
string
时移播放地址
表4-1
4.2时移数据下载
接口地址
/service/api/?
do=shiftdownload
输入参数
参数
类型
说明
必填
sourceid
string
8位的输入源id
是
starttime
string
下载的开始时间（例如：
2013-06-0612:
00:
00）
是
endtime
string
下载的结束时间（例如：
2013-06-0612:
10:
00）
是
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
url
string
时移数据下载地址
表4-2
4.3时移数据详细信息
接口地址
/service/api/?
do=getshiftdetail
输入参数
参数
类型
说明
必填
sourceid
string
8位的输入源id
是
datetime
string
时移数据的日期（8位的绝对时间，例如：
20130707）
否
输出结果
字段
类型
说明
errors
string
错误的原因（操作失败时出现）
success
boolean
值为true（操作成功时出现）
record
array
时移数据记录数组（详细见表4-2）
表4-3
Recordarray时移数据记录数组
times
array
具体时移数据时间段数组
start
string
时移数据的开始时间点（如：
20130703101616）
end
string
时移数据的结束时间点（如：
20130703102235）
day
string
时移数据的日期（如：
20130703）
表4-4
升级会员 