580 lines
22 KiB
Markdown
580 lines
22 KiB
Markdown
WVP 推流相关接口
|
||
1️⃣ 推流列表接口
|
||
接口：GET /api/push/list 路径：StreamPushController.java:73-95 完整 URL：
|
||
GET http://114.67.89.4:9090/api/push/list
|
||
参数：
|
||
page: 当前页（可选）
|
||
count: 每页查询数量（可选）
|
||
query: 查询内容（可选）
|
||
pushing: 是否正在推流（可选，true/false）
|
||
mediaServerId: 流媒体ID（可选）
|
||
返回示例：
|
||
{
|
||
"list": [
|
||
{
|
||
"id": 1,
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"gbId": "34020000001320000001",
|
||
"name": "测试推流",
|
||
"pushing": true,
|
||
"mediaServerId": "polaris",
|
||
"createTime": "2025-12-09 16:00:00"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"pageNum": 1,
|
||
"pageSize": 10
|
||
}
|
||
2️⃣ 开始播放接口（获取流地址）
|
||
接口：GET /api/push/start 路径：StreamPushController.java:258-286 完整 URL：
|
||
GET http://114.67.89.4:9090/api/push/start?id=1
|
||
参数：
|
||
id: 推流ID（必填，从推流列表中获取）
|
||
返回示例：
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": {
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"mediaServerId": "polaris",
|
||
"flv": "http://114.67.89.4:8778/live/prod.live.flv",
|
||
"https_flv": "https://114.67.89.4:443/live/prod.live.flv",
|
||
"ws_flv": "ws://114.67.89.4:8778/live/prod.live.flv",
|
||
"wss_flv": "wss://114.67.89.4:443/live/prod.live.flv",
|
||
"fmp4": "http://114.67.89.4:8778/live/prod.live.mp4",
|
||
"https_fmp4": "https://114.67.89.4:443/live/prod.live.mp4",
|
||
"ws_fmp4": "ws://114.67.89.4:8778/live/prod.live.mp4",
|
||
"wss_fmp4": "wss://114.67.89.4:443/live/prod.live.mp4",
|
||
"hls": "http://114.67.89.4:8778/live/prod/hls.m3u8",
|
||
"https_hls": "https://114.67.89.4:443/live/prod/hls.m3u8",
|
||
"ts": "http://114.67.89.4:8778/live/prod.live.ts",
|
||
"https_ts": "https://114.67.89.4:443/live/prod.live.ts",
|
||
"ws_ts": "ws://114.67.89.4:8778/live/prod.live.ts",
|
||
"wss_ts": "wss://114.67.89.4:443/live/prod.live.ts",
|
||
"rtmp": "rtmp://114.67.89.4:10001/live/prod",
|
||
"rtsp": "rtsp://114.67.89.4:10002/live/prod",
|
||
"rtc": "http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play",
|
||
"rtc_https": "https://114.67.89.4:443/index/api/webrtc?app=live&stream=prod&type=play"
|
||
}
|
||
}
|
||
关键字段说明：
|
||
rtc: WebRTC 播放地址（HTTP）
|
||
rtc_https: WebRTC 播放地址（HTTPS）
|
||
flv: HTTP-FLV 播放地址
|
||
hls: HLS 播放地址
|
||
rtmp: RTMP 播放地址
|
||
rtsp: RTSP 播放地址
|
||
完整使用流程
|
||
步骤 1：查询推流列表
|
||
curl 'http://114.67.89.4:9090/api/push/list?page=1&count=10&pushing=true'
|
||
返回：
|
||
{
|
||
"list": [
|
||
{
|
||
"id": 123,
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"pushing": true
|
||
}
|
||
]
|
||
}
|
||
步骤 2：获取播放地址（包括 WebRTC）
|
||
curl 'http://114.67.89.4:9090/api/push/start?id=123'
|
||
返回：
|
||
{
|
||
"code": 0,
|
||
"data": {
|
||
"rtc": "http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play",
|
||
"flv": "http://114.67.89.4:8778/live/prod.live.flv",
|
||
"hls": "http://114.67.89.4:8778/live/prod/hls.m3u8",
|
||
"rtmp": "rtmp://114.67.89.4:10001/live/prod",
|
||
"rtsp": "rtsp://114.67.89.4:10002/live/prod"
|
||
}
|
||
}
|
||
步骤 3：使用 WebRTC 播放
|
||
WebRTC 播放地址：
|
||
http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play
|
||
这个地址可以直接用于 WebRTC 播放器，例如：
|
||
在网页中使用 WebRTC 播放器
|
||
使用 ZLM 提供的 WebRTC 客户端
|
||
测试接口
|
||
让我测试一下这些接口：
|
||
Bash Test WVP push list API
|
||
IN
|
||
curl -s 'http://114.67.89.4:9090/api/push/list?page=1&count=10' | python3 -m json.tool | head -50
|
||
OUT
|
||
{
|
||
"code": 401,
|
||
"msg": "\u8bf7\u767b\u5f55\u540e\u91cd\u65b0\u8bf7\u6c42"
|
||
}
|
||
看到了，WVP 的接口需要登录认证。让我帮你获取登录 token，然后测试接口。
|
||
Bash Login to WVP and get token
|
||
IN
|
||
ssh ZTE "curl -s -X POST 'http://127.0.0.1:18978/api/user/login' -H 'Content-Type: application/json' -d '{\"username\":\"admin\",\"password\":\"admin\"}' | python3 -m json.tool"
|
||
OUT
|
||
{
|
||
"code": 400,
|
||
"msg": "\u53c2\u6570\u6216\u65b9\u6cd5\u9519\u8bef",
|
||
"data": null
|
||
}
|
||
让我查找正确的登录接口：
|
||
Grep "@PostMapping.*login|@GetMapping.*login" (in /Users/sunpeng/workspace/stream-deploy/docker/wvp/wvpcode/src/main/java/com/genersoft/iot/vmp, glob: **/*Controller.java)
|
||
41 lines of output
|
||
好的，我看到登录接口需要 MD5 加密的密码。让我测试完整的流程：
|
||
Bash Calculate MD5 of admin password and login to WVP
|
||
IN
|
||
ssh ZTE "
|
||
# 计算 admin 的 MD5
|
||
PASSWORD_MD5=\$(echo -n 'admin' | md5sum | awk '{print \$1}')
|
||
echo \"Password MD5: \$PASSWORD_MD5\"
|
||
|
||
# 登录获取 token
|
||
curl -s 'http://127.0.0.1:18978/api/user/login?username=admin&password='\$PASSWORD_MD5 | python3 -m json.tool
|
||
"
|
||
OUT
|
||
Password MD5: 21232f297a57a5a743894a0e4a801fc3
|
||
{
|
||
"code": 0,
|
||
"msg": "\u6210\u529f",
|
||
"data": {
|
||
"accessToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0.eyJqdGkiOiJ6Skw2Rzd4X2NNRXZRT0FiWTV3dkl3IiwiaWF0IjoxNzY1MjcyODA2LCJleHAiOjE3NjUyNzY0MDYsIm5iZiI6MTc2NTI3MjgwNiwic3ViIjoibG9naW4iLCJhdWQiOiJBdWRpZW5jZSIsInVzZXJOYW1lIjoiYWRtaW4ifQ.kYBL6VC7hAiYWsX9_MoRXwZmwnpcAt5oi1ZHCtZDTHCoAIUxl_VkNCee7M6L1v2bdmjFxH_PXVygK2jaiLTyPjZloIesHgocFJwikgMAAtxeTZreuEd1Kw7r2nPNHxmZadgjHDqz-gyz2O1E9xOtYTmwMyZYaftOUhZfogAxIbNkt18X2Umdt7mRuIDLsFw0LP0Hcp2273C56F4-hVfF5lxsHtcLPtbq7HppTFMYQwC0KaZBbST6WMjhzbby5Vr3LIcA2BEvOflUigD5goQSM47q-fu87fpx4VFkPzS8pkRWHIGM1Vvjry0jPCW1b6Lk_FhV5Z3IjjUa_Ju4ds6GlA",
|
||
"serverId": "000000",
|
||
"id": 1,
|
||
"enabled": true,
|
||
"password": null,
|
||
"role": {
|
||
"id": 1,
|
||
"name": "admin",
|
||
"authority": "0",
|
||
"createTime": "2021-04-13 14:14:57",
|
||
"updateTime": "2021-04-13 14:14:57"
|
||
},
|
||
"username": "admin",
|
||
"pushKey": "3e80d1762a324d5b0ff636e0bd16f1e3",
|
||
"authorities": null,
|
||
"accountNonExpired": true,
|
||
"accountNonLocked": true,
|
||
"credentialsNonExpired": true
|
||
}
|
||
}
|
||
完美！登录成功了。现在让我使用这个 token 测试推流列表和播放接口：
|
||
Bash Test WVP push list API with token
|
||
IN
|
||
ssh ZTE "
|
||
TOKEN='eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0.eyJqdGkiOiJ6Skw2Rzd4X2NNRXZRT0FiWTV3dkl3IiwiaWF0IjoxNzY1MjcyODA2LCJleHAiOjE3NjUyNzY0MDYsIm5iZiI6MTc2NTI3MjgwNiwic3ViIjoibG9naW4iLCJhdWQiOiJBdWRpZW5jZSIsInVzZXJOYW1lIjoiYWRtaW4ifQ.kYBL6VC7hAiYWsX9_MoRXwZmwnpcAt5oi1ZHCtZDTHCoAIUxl_VkNCee7M6L1v2bdmjFxH_PXVygK2jaiLTyPjZloIesHgocFJwikgMAAtxeTZreuEd1Kw7r2nPNHxmZadgjHDqz-gyz2O1E9xOtYTmwMyZYaftOUhZfogAxIbNkt18X2Umdt7mRuIDLsFw0LP0Hcp2273C56F4-hVfF5lxsHtcLPtbq7HppTFMYQwC0KaZBbST6WMjhzbby5Vr3LIcA2BEvOflUigD5goQSM47q-fu87fpx4VFkPzS8pkRWHIGM1Vvjry0jPCW1b6Lk_FhV5Z3IjjUa_Ju4ds6GlA'
|
||
|
||
echo '=== 1. 查询推流列表 ==='
|
||
curl -s 'http://127.0.0.1:18978/api/push/list?page=1&count=10' -H 'access-token: '\$TOKEN | python3 -m json.tool
|
||
"
|
||
OUT
|
||
=== 1. 查询推流列表 ===
|
||
{
|
||
"code": 0,
|
||
"msg": "\u6210\u529f",
|
||
"data": {
|
||
"total": 1,
|
||
"list": [
|
||
{
|
||
"gbId": 0,
|
||
"gbDeviceId": null,
|
||
"gbName": null,
|
||
"gbManufacturer": null,
|
||
"gbModel": null,
|
||
"gbOwner": null,
|
||
"gbCivilCode": null,
|
||
"gbBlock": null,
|
||
"gbAddress": null,
|
||
"gbParental": null,
|
||
"gbParentId": null,
|
||
"gbSafetyWay": null,
|
||
"gbRegisterWay": null,
|
||
"gbCertNum": null,
|
||
"gbCertifiable": null,
|
||
"gbErrCode": null,
|
||
"gbEndTime": null,
|
||
"gbSecrecy": null,
|
||
"gbIpAddress": null,
|
||
"gbPort": null,
|
||
"gbPassword": null,
|
||
"gbStatus": null,
|
||
"gbLongitude": null,
|
||
"gbLatitude": null,
|
||
"gpsAltitude": null,
|
||
"gpsSpeed": null,
|
||
"gpsDirection": null,
|
||
"gpsTime": null,
|
||
"gbBusinessGroupId": null,
|
||
"gbPtzType": null,
|
||
"gbPositionType": null,
|
||
"gbRoomType": null,
|
||
"gbUseType": null,
|
||
"gbSupplyLightType": null,
|
||
"gbDirectionType": null,
|
||
"gbResolution": null,
|
||
"gbDownloadSpeed": null,
|
||
"gbSvcSpaceSupportMod": null,
|
||
"gbSvcTimeSupportMode": null,
|
||
"recordPLan": null,
|
||
"dataType": 2,
|
||
"dataDeviceId": 4,
|
||
"createTime": "2025-12-09 16:06:23",
|
||
"updateTime": "2025-12-09 16:06:23",
|
||
"streamId": null,
|
||
"enableBroadcast": null,
|
||
"mapLevel": null,
|
||
"id": 4,
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"mediaServerId": "polaris",
|
||
"serverId": "000000",
|
||
"pushTime": "2025-12-09 16:06:23",
|
||
"pushing": true,
|
||
"startOfflinePush": false,
|
||
"uniqueKey": null
|
||
}
|
||
],
|
||
"pageNum": 1,
|
||
"pageSize": 10,
|
||
"size": 1,
|
||
"startRow": 1,
|
||
"endRow": 1,
|
||
"pages": 1,
|
||
"prePage": 0,
|
||
"nextPage": 0,
|
||
"isFirstPage": true,
|
||
"isLastPage": true,
|
||
"hasPreviousPage": false,
|
||
"hasNextPage": false,
|
||
"navigatePages": 8,
|
||
"navigatepageNums": [
|
||
1
|
||
],
|
||
"navigateFirstPage": 1,
|
||
"navigateLastPage": 1
|
||
}
|
||
}
|
||
完美！推流列表查询成功了。现在让我测试播放接口，获取包括 WebRTC 在内的所有播放地址：
|
||
Bash Test WVP play start API to get stream URLs including WebRTC
|
||
IN
|
||
ssh ZTE "
|
||
TOKEN='eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0.eyJqdGkiOiJ6Skw2Rzd4X2NNRXZRT0FiWTV3dkl3IiwiaWF0IjoxNzY1MjcyODA2LCJleHAiOjE3NjUyNzY0MDYsIm5iZiI6MTc2NTI3MjgwNiwic3ViIjoibG9naW4iLCJhdWQiOiJBdWRpZW5jZSIsInVzZXJOYW1lIjoiYWRtaW4ifQ.kYBL6VC7hAiYWsX9_MoRXwZmwnpcAt5oi1ZHCtZDTHCoAIUxl_VkNCee7M6L1v2bdmjFxH_PXVygK2jaiLTyPjZloIesHgocFJwikgMAAtxeTZreuEd1Kw7r2nPNHxmZadgjHDqz-gyz2O1E9xOtYTmwMyZYaftOUhZfogAxIbNkt18X2Umdt7mRuIDLsFw0LP0Hcp2273C56F4-hVfF5lxsHtcLPtbq7HppTFMYQwC0KaZBbST6WMjhzbby5Vr3LIcA2BEvOflUigD5goQSM47q-fu87fpx4VFkPzS8pkRWHIGM1Vvjry0jPCW1b6Lk_FhV5Z3IjjUa_Ju4ds6GlA'
|
||
|
||
echo '=== 2. 获取播放地址（包括 WebRTC） ==='
|
||
curl -s 'http://127.0.0.1:18978/api/push/start?id=4' -H 'access-token: '\$TOKEN | python3 -m json.tool
|
||
"
|
||
OUT
|
||
=== 2. 获取播放地址（包括 WebRTC） ===
|
||
{
|
||
"code": 0,
|
||
"msg": "\u6210\u529f",
|
||
"data": {
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"ip": null,
|
||
"flv": "http://114.67.89.4:8778/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"https_flv": "https://114.67.89.4:443/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ws_flv": "ws://114.67.89.4:8778/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"wss_flv": "wss://114.67.89.4:443/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"fmp4": "http://114.67.89.4:8778/live/prod.live.mp4?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"https_fmp4": "https://114.67.89.4:443/live/prod.live.mp4?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ws_fmp4": "ws://114.67.89.4:8778/live/prod.live.mp4?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"wss_fmp4": "wss://114.67.89.4:443/live/prod.live.mp4?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"hls": "http://114.67.89.4:8778/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"https_hls": "https://114.67.89.4:443/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ws_hls": "ws://114.67.89.4:8778/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"wss_hls": "wss://114.67.89.4:443/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ts": "http://114.67.89.4:8778/live/prod.live.ts?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"https_ts": "https://114.67.89.4:443/live/prod.live.ts?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ws_ts": "ws://114.67.89.4:8778/live/prod.live.ts?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"wss_ts": null,
|
||
"rtmp": "rtmp://114.67.89.4:10001/live/prod?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtmps": null,
|
||
"rtsp": "rtsp://114.67.89.4:10002/live/prod?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtsps": null,
|
||
"rtc": "http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play&originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtcs": "https://114.67.89.4:443/index/api/webrtc?app=live&stream=prod&type=play&originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"mediaServerId": "polaris",
|
||
"mediaInfo": {
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"mediaServer": {
|
||
"id": "polaris",
|
||
"ip": "polaris-media",
|
||
"hookIp": "polaris-wvp",
|
||
"sdpIp": "114.67.89.4",
|
||
"streamIp": "114.67.89.4",
|
||
"httpPort": 8778,
|
||
"httpSSlPort": 443,
|
||
"rtmpPort": 10001,
|
||
"flvPort": 9090,
|
||
"flvSSLPort": 443,
|
||
"mp4Port": 0,
|
||
"wsFlvPort": 9090,
|
||
"wsFlvSSLPort": 443,
|
||
"rtmpSSlPort": 0,
|
||
"rtpProxyPort": 10003,
|
||
"jttProxyPort": 0,
|
||
"rtspPort": 10002,
|
||
"rtspSSLPort": 0,
|
||
"autoConfig": true,
|
||
"secret": "su6TiedN2rVAmBbIDX0aa0QTiBJLBdcf",
|
||
"hookAliveInterval": 10.0,
|
||
"rtpEnable": true,
|
||
"status": true,
|
||
"rtpPortRange": "30000,30500",
|
||
"sendRtpPortRange": "50502,50506",
|
||
"recordAssistPort": 0,
|
||
"createTime": "2025-12-09 11:02:16",
|
||
"updateTime": "2025-12-09 11:02:16",
|
||
"lastKeepaliveTime": null,
|
||
"defaultServer": true,
|
||
"recordDay": 7,
|
||
"recordPath": "/opt/media/bin/www/record/",
|
||
"type": "zlm",
|
||
"transcodeSuffix": null,
|
||
"serverId": "000000"
|
||
},
|
||
"schema": "rtsp",
|
||
"readerCount": 6,
|
||
"videoCodec": "H264",
|
||
"width": 1280,
|
||
"height": 720,
|
||
"fps": 30,
|
||
"loss": -1,
|
||
"audioCodec": "AAC",
|
||
"audioChannels": 1,
|
||
"audioSampleRate": 24000,
|
||
"duration": 5258065,
|
||
"online": null,
|
||
"originType": 1,
|
||
"originTypeStr": "rtmp_push",
|
||
"originUrl": null,
|
||
"aliveSecond": 5262,
|
||
"bytesSpeed": 319956,
|
||
"callId": null,
|
||
"paramMap": {
|
||
"sign": "41db35390ddad33f83944f44b8b75ded"
|
||
},
|
||
"serverId": "000000"
|
||
},
|
||
"startTime": null,
|
||
"endTime": null,
|
||
"duration": null,
|
||
"downLoadFilePath": null,
|
||
"transcodeStream": null,
|
||
"progress": 0.0,
|
||
"key": null,
|
||
"serverId": "000000"
|
||
}
|
||
}
|
||
完美！测试成功了。现在让我为你整理完整的 WVP 推流接口文档。
|
||
WVP 推流接口完整文档
|
||
📋 1. 登录接口
|
||
接口：GET/POST /api/user/login 参数：
|
||
username: 用户名（例如：admin）
|
||
password: 密码的 MD5 值（例如：admin 的 MD5 是 21232f297a57a5a743894a0e4a801fc3）
|
||
示例：
|
||
# 计算密码的 MD5
|
||
echo -n "admin" | md5
|
||
# 输出: 21232f297a57a5a743894a0e4a801fc3
|
||
|
||
# 登录
|
||
curl 'http://114.67.89.4:9090/api/user/login?username=admin&password=21232f297a57a5a743894a0e4a801fc3'
|
||
返回：
|
||
{
|
||
"code": 0,
|
||
"msg": "成功",
|
||
"data": {
|
||
"accessToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0...",
|
||
"username": "admin",
|
||
"pushKey": "3e80d1762a324d5b0ff636e0bd16f1e3"
|
||
}
|
||
}
|
||
重要：后续所有接口都需要在请求头中添加 access-token：
|
||
-H 'access-token: eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0...'
|
||
📋 2. 推流列表接口
|
||
接口：GET /api/push/list 参数：
|
||
page: 当前页（可选）
|
||
count: 每页数量（可选）
|
||
query: 查询内容（可选）
|
||
pushing: 是否正在推流（可选，true/false）
|
||
mediaServerId: 流媒体ID（可选）
|
||
示例：
|
||
curl 'http://114.67.89.4:9090/api/push/list?page=1&count=10&pushing=true' \
|
||
-H 'access-token: YOUR_TOKEN'
|
||
返回：
|
||
{
|
||
"code": 0,
|
||
"msg": "成功",
|
||
"data": {
|
||
"total": 1,
|
||
"list": [
|
||
{
|
||
"id": 4,
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"mediaServerId": "polaris",
|
||
"pushing": true,
|
||
"pushTime": "2025-12-09 16:06:23",
|
||
"createTime": "2025-12-09 16:06:23"
|
||
}
|
||
],
|
||
"pageNum": 1,
|
||
"pageSize": 10
|
||
}
|
||
}
|
||
关键字段：
|
||
id: 推流ID（用于后续获取播放地址）
|
||
app: 应用名
|
||
stream: 流ID
|
||
pushing: 是否正在推流
|
||
📋 3. 获取播放地址接口（包括 WebRTC）
|
||
接口：GET /api/push/start 参数：
|
||
id: 推流ID（必填，从推流列表中获取）
|
||
示例：
|
||
curl 'http://114.67.89.4:9090/api/push/start?id=4' \
|
||
-H 'access-token: YOUR_TOKEN'
|
||
返回：
|
||
{
|
||
"code": 0,
|
||
"msg": "成功",
|
||
"data": {
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"flv": "http://114.67.89.4:8778/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"ws_flv": "ws://114.67.89.4:8778/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"hls": "http://114.67.89.4:8778/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtmp": "rtmp://114.67.89.4:10001/live/prod?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtsp": "rtsp://114.67.89.4:10002/live/prod?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtc": "http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play&originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtcs": "https://114.67.89.4:443/index/api/webrtc?app=live&stream=prod&type=play&originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"mediaInfo": {
|
||
"videoCodec": "H264",
|
||
"width": 1280,
|
||
"height": 720,
|
||
"fps": 30,
|
||
"audioCodec": "AAC",
|
||
"audioChannels": 1,
|
||
"audioSampleRate": 24000
|
||
}
|
||
}
|
||
}
|
||
播放地址字段说明：
|
||
字段 协议 说明
|
||
rtc WebRTC (HTTP) 低延迟播放，推荐
|
||
rtcs WebRTC (HTTPS) 低延迟播放（HTTPS）
|
||
flv HTTP-FLV HTTP 流式播放
|
||
ws_flv WebSocket-FLV WebSocket 流式播放
|
||
hls HLS M3U8 播放
|
||
rtmp RTMP RTMP 播放
|
||
rtsp RTSP RTSP 播放
|
||
fmp4 HTTP-FMP4 FMP4 流式播放
|
||
ts HTTP-TS TS 流式播放
|
||
完整使用流程
|
||
步骤 1：登录获取 Token
|
||
# 计算密码 MD5
|
||
PASSWORD_MD5=$(echo -n "admin" | md5)
|
||
|
||
# 登录
|
||
curl 'http://114.67.89.4:9090/api/user/login?username=admin&password='$PASSWORD_MD5
|
||
返回：
|
||
{
|
||
"data": {
|
||
"accessToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0..."
|
||
}
|
||
}
|
||
保存 accessToken 用于后续请求。
|
||
步骤 2：查询推流列表
|
||
TOKEN="eyJhbGciOiJSUzI1NiIsImtpZCI6IjNlNzk2NDZjNGRiYzQwODM4M2E5ZWVkMDlmMmI4NWFlIn0..."
|
||
|
||
curl 'http://114.67.89.4:9090/api/push/list?page=1&count=10&pushing=true' \
|
||
-H "access-token: $TOKEN"
|
||
返回：
|
||
{
|
||
"data": {
|
||
"list": [
|
||
{
|
||
"id": 4,
|
||
"app": "live",
|
||
"stream": "prod",
|
||
"pushing": true
|
||
}
|
||
]
|
||
}
|
||
}
|
||
记录 id 字段（例如：4）。
|
||
步骤 3：获取播放地址（包括 WebRTC）
|
||
curl 'http://114.67.89.4:9090/api/push/start?id=4' \
|
||
-H "access-token: $TOKEN"
|
||
返回：
|
||
{
|
||
"data": {
|
||
"rtc": "http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play&originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"flv": "http://114.67.89.4:8778/live/prod.live.flv?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"hls": "http://114.67.89.4:8778/live/prod/hls.m3u8?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264",
|
||
"rtmp": "rtmp://114.67.89.4:10001/live/prod?originTypeStr=rtmp_push&audioCodec=AAC&videoCodec=H264"
|
||
}
|
||
}
|
||
步骤 4：使用播放地址
|
||
WebRTC 播放（推荐，低延迟）
|
||
http://114.67.89.4:8778/index/api/webrtc?app=live&stream=prod&type=play
|
||
HTTP-FLV 播放
|
||
http://114.67.89.4:8778/live/prod.live.flv
|
||
HLS 播放
|
||
http://114.67.89.4:8778/live/prod/hls.m3u8
|
||
Python 示例代码
|
||
import requests
|
||
import hashlib
|
||
|
||
# 配置
|
||
BASE_URL = "http://114.67.89.4:9090"
|
||
USERNAME = "admin"
|
||
PASSWORD = "admin"
|
||
|
||
# 1. 登录
|
||
password_md5 = hashlib.md5(PASSWORD.encode()).hexdigest()
|
||
response = requests.get(f"{BASE_URL}/api/user/login", params={
|
||
"username": USERNAME,
|
||
"password": password_md5
|
||
})
|
||
token = response.json()["data"]["accessToken"]
|
||
print(f"Token: {token}")
|
||
|
||
# 2. 查询推流列表
|
||
headers = {"access-token": token}
|
||
response = requests.get(f"{BASE_URL}/api/push/list", headers=headers, params={
|
||
"page": 1,
|
||
"count": 10,
|
||
"pushing": True
|
||
})
|
||
push_list = response.json()["data"]["list"]
|
||
print(f"推流列表: {push_list}")
|
||
|
||
# 3. 获取播放地址
|
||
if push_list:
|
||
push_id = push_list[0]["id"]
|
||
response = requests.get(f"{BASE_URL}/api/push/start", headers=headers, params={
|
||
"id": push_id
|
||
})
|
||
play_urls = response.json()["data"]
|
||
print(f"\n播放地址：")
|
||
print(f"WebRTC: {play_urls['rtc']}")
|
||
print(f"HTTP-FLV: {play_urls['flv']}")
|
||
print(f"HLS: {play_urls['hls']}")
|
||
print(f"RTMP: {play_urls['rtmp']}")
|
||
print(f"RTSP: {play_urls['rtsp']}")
|
||
总结
|
||
WVP 推流接口特点
|
||
✅ 统一的接口：通过推流 ID 获取所有播放地址
|
||
✅ 包含 WebRTC：支持低延迟播放
|
||
✅ 多种协议：FLV、HLS、RTMP、RTSP、WebRTC 等
|
||
✅ 媒体信息：返回视频编码、分辨率、帧率等详细信息
|
||
✅ 需要认证：所有接口都需要 access-token
|
||
关键接口
|
||
接口 说明
|
||
/api/user/login 登录获取 token
|
||
/api/push/list 查询推流列表
|
||
/api/push/start 获取播放地址（包括 WebRTC）
|
||
这就是完整的 WVP 推流接口文档！ |