建立頻道

舊版介面位址建立單一頻道（舊版）

舊版介面升級新版注意事項

1. 舊版介面建立頻道時，能直接設定頻道基本資訊、觀看條件、回放設定、講師設定、角色設定；
   
2. 新版介面建立頻道時，只能設定頻道基本資訊，觀看條件、回放設定、講師設定、角色設定來源於預設模板設定，在建立頻道前需設定好預設模板；
   
3. 預設模板的修改不會對已建立的頻道產生影響，已建立頻道資訊的修改與舊版介面一致；
   
4. 舊版介面直播場景（scene）對應本介面直播模板（template），由於舊版介面無場景（newScene欄位）概念，舊版升級新版後，使用舊版介面建立的頻道，在新版直播後台的場景會顯示未定義，對資料無影響

介面描述

1、根据直播默认模板创建频道
2、（timestamp, appId）参与sign签名，并和sign一起通过url传递，请求体参数不参与签名，通过post请求体传递【请设置请求头contentType:application/json】
3、接口支持https协议

接口URL

http://api.polyv.net/live/v4/channel/create

線上API呼叫

請求方式

POST

介面限制

1、介面同時支援 HTTP 與 HTTPS，建議使用 HTTPS 以確保介面安全，介面呼叫有頻率限制，詳細請參閱

2、直播場景為雙師課、研討會時，不支援轉播類型設定；直播延遲為無延遲時，不支援轉播類型設定；

3、直播場景為研討會時，不支援直播延遲、轉播、連麥人數設定；

4、研討會場景下主持人密碼與參與者密碼不能相同；

請求參數說明

請求體參數說明

範例

http://api.polyv.net/live/v4/channel/create?appId=frlr1zazn3&sign=E3F501CFEF5FCCF2DF9BFDCE9C91F48C&timestamp=1629445373947

請求體 JSON 參數：

{
    "template": "ppt",
    "doubleTeacherType": "normal",
    "name": "polyv小课堂",
    "startTime": "1779254040000",
    "newScene": "topclass",
    "newSessionEnabled": "Y",
    "type": "normal",
    "pureRtcEnabled": "Y",
    "linkMicLimit": "6",
    "labelData":[]
}

回應參數說明

Data參數描述

Java 請求範例

快速接入基礎程式碼請下載相關依賴原始碼， 點擊下載原始碼 ，下載後加入自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下載檔案中。

強烈建議您使用直播 Java SDK完成 API 的功能對接，直播 Java SDK 對 API 呼叫邏輯、例外處理、資料簽章、HTTP 請求執行緒池進行了統一封裝和最佳化。

    /**
     * 创建单个频道
     * @throws IOException
     * @throws NoSuchAlgorithmException
     */
    @Test
    public void testBasicCreateV4() throws IOException, NoSuchAlgorithmException {
        //公共参数,填写自己的实际
        String appId = super.appId;
        String appSecret = super.appSecret;
        String userId = super.userId;
        String timestamp = String.valueOf(System.currentTimeMillis());
        //业务参数
        String url = "http://api.polyv.net/live/v4/channel/create";
        
        String name = "polyv小课堂";
        String newScene = "topclass";
        String template = "ppt";
        String pureRtcEnabled = "Y";
        String type = "normal";
        String doubleTeacherType = "normal";
        String cnAndEnLiveEnabled = "N";
        String linkMicLimit = "5";
        String categoryId = "";
        Long startTime = new Date().getTime() + 30 * 60 * 1000l;
        
        //http 调用逻辑
        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp", timestamp);
        
        Map<String, String> bodyMap = new HashMap<>();
        bodyMap.put("name", name);
        bodyMap.put("newScene", newScene);
        bodyMap.put("template", template);
        bodyMap.put("pureRtcEnabled", pureRtcEnabled);
        bodyMap.put("type", type);
        bodyMap.put("doubleTeacherType", doubleTeacherType);
        bodyMap.put("cnAndEnLiveEnabled", cnAndEnLiveEnabled);
        bodyMap.put("linkMicLimit", linkMicLimit);
//      bodyMap.put("categoryId", categoryId);
        bodyMap.put("channelPasswd", "Y2KRyUauSITWv");
//      bodyMap.put("seminarHostPassword", "lLnAtoeNfAID3");
//      bodyMap.put("seminarAttendeePassword", "cpoonjki9CRBh");
        bodyMap.put("startTime", String.valueOf(startTime));
        
        requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
        
        String body = JSON.toJSONString(bodyMap);
        url = HttpUtil.appendUrl(url, requestMap);
        String response = HttpUtil.postJsonBody(url,body,null);
        
        log.info("测试创建单个频道，返回值：{}", response);
        //do somethings
        
        }

回應範例

系統全域錯誤說明詳見全域錯誤說明

成功範例

{
    "code": 200,
    "status": "success",
    "requestId": "847f0716fa76461baf8979aaa4415dc3.67.16342672396023837",
    "data": {
        "channelId": 2614804,
        "userId": "1b448be323",
        "scene": null,
        "channelPasswd": "jvO3RbFTKE61A",
        "seminarHostPassword": null,
        "seminarAttendeePassword": null
    },
    "success": true
}

異常範例

{
    "code": 400,
    "status": "error",
    "requestId": "4081dbac03e6441e8bdd301d8feee5a2.124.16360831818611581",
    "error": {
        "code": 20001,
        "desc": "application not found."
    },
    "success": false
}