视频点播视频直播中二次开发接口对接说明示列

一站式的转码、点播、直播、时移回放服务，极大地简化了开发和集成的工作。其中，点播版本主要包含：上传、转码、分发。直播版本，主要包含：直播、录像， 直播支持RTMP输入，RTMP/HLS/HTTP-FLV的分发输出；录像支持自定义保存时长、检索及下载。提供丰富的二次开发接口，基于JSON的封装及HTTP调用。提供播放鉴权、推流鉴权等安全保证。提供用户及相关权限管理配置。

一、 快速安装

1. 下载地址
2. 下载对应环境的安装包
3. 解压安装包
4. Windows下双击LiveQing.exe直接启动
5. Linux下解压目录执行./start.sh
6. 详见：https://blog.csdn.net/Marvin1311/article/details/88797606

注：路径中不能包含中文

二、 二次开发

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

1. 封闭内网使用

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

2. 业务系统对接

2.1 cookie方式

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

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

2.1.1 前端js跨域请求示例

客户端不必显示保存 token 到 cookie. 所有和服务的交互接口需要添加跨域配置, xhrFields: { withCredentials: true } 和 crossDomain: true，前提是服务端配置允许跨域。

例如跨域登录接口调用示例如下:

$.ajax({
    type: "GET",
    url: "http://other-domain:10080/login",
    xhrFields: { 
        withCredentials: true
    },
    crossDomain: true, 
    data: {
        username: 'admin',
        password: '21232f297a57a5a743894a0e4a801fc3'
    },
    success: function(data) {
        console.log(data);
    }
})

后端代码示例：Java

2.1.2 获取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://demo.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> headerFields = conn.getHeaderFields();
		
        Set headerFieldsSet = headerFields.keySet();
		
        Iterator hearerFieldsIter = headerFieldsSet.iterator();

        while (hearerFieldsIter.hasNext()) {

            String headerFieldKey = hearerFieldsIter.next();

            if ("Set-Cookie".equalsIgnoreCase(headerFieldKey)) {

                List 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.3 携带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");
		//这里传递上一步获得sid
        conn.setRequestProperty("Cookie","sid=Hwsd2R;"); 
        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方式

1. 调用登录接口获取token
2. Content-Type:application/x-www-form-urlencoded
3. 其它接口调用时传递附加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());
    }
  }

运行如下

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());
    }
 }

运行如下