视频点播RTMP推流直播流媒体服务二次开发集成接口

LiveQing流媒体服务器软件，提供一站式的转码、点播、直播、时移回放服务，极大地简化了开发和集成的工作。

其中，点播功能主要包含：上传、转码、分发。直播功能，主要包含：直播、录像，直播支持RTMP输入，RTMP/HLS/HTTP-FLV的分发输出；录像支持自定义保存时长、检索及下载。提供丰富的二次开发接口，基于JSON的封装及HTTP调用。提供播放鉴权、推流鉴权等安全保证。提供用户及相关权限管理配置。

一、接口列表

http://demo.liveqing.com:10080/apidoc/

二、集成二次开发

二次开发中，方式是在自己业务系统后端登录接口中，调用流媒体的登录接口，获取所需的sid或是token

1. 封闭内网使用

在业务使用，如果只是使用LiveQing提供视频分发能力，且不会对外公开接口端口10080(默认端口)，可以直接将接口鉴权关闭，具体服务器登录 http://localhost:10080 默认用户名/密码 admin/admin, 在基础配置页面，【接口鉴权】开关。

在这里插入图片描述

2. 业务系统对接(两种方式)

2.1 cookie方式

注： HttpOnly = true 客户端API（例如JavaScript）无法访问仅限http的cookie。此限制通过跨站点脚本（XSS）消除了cookie被盗的威胁。

在后端业务代码中对接，如Java/PHP/Node.js 等
调用LiveQing登录接口，接口调用成功后会在请求Headers的cookie中写入sid
取出cookie里的sid
其它接口调用时在请求头cookies中传递sid
Content-Type:application/x-www-form-urlencoded
接口请求路径示例：http://localhost:10080/login

代码示例：Java

2.1.1 获取sid

  import java.io.DataOutputStream;import java.net.HttpURLConnection;import java.net.URL;import java.util.Iterator;import java.util.List;import java.util.Map;import java.util.Set;public class GetLoginSid {public static void main(String[] args) throws Exception {URL url = new URL("http://cloud.liveqing.com:10080/login");//发起POST请求，并传递username，password参数（需要md5加密）HttpURLConnection conn = (HttpURLConnection)url.openConnection();
conn.setDoOutput(true);conn.setDoInput(true);conn.setRequestMethod("POST");     conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");DataOutputStream out = new DataOutputStream(conn.getOutputStream()); String content = "username=admin&password=21232f297a57a5a743894a0e4a801fc3";out.writeBytes(content);out.flush(); out.close();Map<String, List<String>> headerFields = conn.getHeaderFields();Set<String> headerFieldsSet = headerFields.keySet();Iterator<String> hearerFieldsIter = headerFieldsSet.iterator();while (hearerFieldsIter.hasNext()) {String headerFieldKey = hearerFieldsIter.next();if ("Set-Cookie".equalsIgnoreCase(headerFieldKey)) {List<String> headerFieldValue = headerFields.get(headerFieldKey);for (String headerValue : headerFieldValue) {String[] fields = headerValue.split(";\\s*");for (int j = 0; j < fields.length; j++) {if (fields[j].indexOf('=') > 0) {String[] f = fields[j].split("=");if ("Expires".equalsIgnoreCase(f[0])) {                       System.out.println("Expires:" + f[1]);}else if ("Max-Age".equalsIgnoreCase(f[0])) {                 System.out.println("Max-Age:" + f[1]);}else if ("sid".equalsIgnoreCase(f[0])) {  //获取sid   System.out.println("sid:" + f[1]);}}}}}}}}

运行如下
在这里插入图片描述

2.1.2 携带sid调用其它接口

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;public class RequestOtherAPI {public static void main(String[] args) throws Exception {URL url = new URL("http://demo.liveqing.com:10080/live/list");HttpURLConnection conn = (HttpURLConnection)url.openConnection();
conn.setDoOutput(true);conn.setDoInput(true);conn.setRequestMethod("POST");     conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");//这里传递上一步获得sidconn.setRequestProperty("Cookie","sid=s%3Ark-TEuVtm.WnWoXuDY%2FldJuEc64I6TXjd0Fq1eqByEd4ng1UwNb2I;");DataOutputStream out = new DataOutputStream(conn.getOutputStream()); String content = "start=0&limit=10";out.writeBytes(content);out.flush(); out.close();conn.connect();StringBuffer sbf = new StringBuffer();InputStream is = conn.getInputStream();BufferedReader reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));String strRead = null;while ((strRead = reader.readLine()) != null) {sbf.append(strRead);sbf.append("\r\n");}reader.close();System.out.println(sbf.toString());}}

2.2 token方式

调用登录接口获取token，调用时传递 onlytoken=true
如： http://demo.liveqing.com:10080/login?username=admin&password=21232f29757a5a&onlytoken=true
Content-Type:application/x-www-form-urlencoded
其它接口调用时传递附加token入参

代码示例：Java

2.2.1 获取token

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;public class GetLoginToken {public static void main(String[] args) throws Exception {URL url = new URL("http://localhost:10080/login");HttpURLConnection conn = (HttpURLConnection)url.openConnection();
conn.setDoOutput(true);conn.setDoInput(true);conn.setRequestMethod("POST");     conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");DataOutputStream out = new DataOutputStream(conn.getOutputStream()); String content = "username=admin&password=21232f297a57a5a743894a0e4a801fc3";out.writeBytes(content);out.flush(); out.close();conn.connect();StringBuffer sbf = new StringBuffer();InputStream is = conn.getInputStream();BufferedReader reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));String strRead = null;while ((strRead = reader.readLine()) != null) {sbf.append(strRead);sbf.append("\r\n");}reader.close();System.out.println(sbf.toString());}}

运行如下

获取token运行结果

2.2.2 携带token调用其它接口

其他接口调用时，附加token入参

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;public class RequestOtherAPIByToken {
public static void main(String[] args) throws Exception {URL url = new URL("http://localhost:10080/live/list");HttpURLConnection conn = (HttpURLConnection)url.openConnection();
conn.setDoOutput(true);conn.setDoInput(true);conn.setRequestMethod("POST");     conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");DataOutputStream out = new DataOutputStream(conn.getOutputStream()); String content = "start=0&limit=10&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1Mzc3NzExNTAsInB3IjoiMjEyMzJmMjk3YTU3YTVhNzQzODk0YTBlNGE4MDFmYzMiLCJ0bSI6MTUzNzY4NDc1MCwidW4iOiJhZG1pbiJ9.b1U-R-_HVKV9reWRD50327B1ztUqs3gowUGi_lDzlmU";out.writeBytes(content);out.flush(); out.close();conn.connect();StringBuffer sbf = new StringBuffer();InputStream is = conn.getInputStream();BufferedReader reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));String strRead = null;while ((strRead = reader.readLine()) != null) {sbf.append(strRead);sbf.append("\r\n");}reader.close();System.out.println(sbf.toString());}
}

运行如下
在这里插入图片描述