channelService

1、建立研討會頻道(舊版後台)

描述

创建频道并进行相关设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/basic/create

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testCreateChannel() throws IOException, NoSuchAlgorithmException {
        SeminarCreateChannelRequest seminarCreateChannelRequest = new SeminarCreateChannelRequest();
        SeminarCreateChannelResponse seminarCreateChannelResponse;
        try {
            SeminarCreateChannelRequest.BasicSetting basicSetting = new SeminarCreateChannelRequest.BasicSetting();
            basicSetting.setName("测试SDK创建研讨会")
                    .setChannelPasswd(super.getRandomString(6))
                    .setCategoryId(super.getCategory());
            SeminarCreateChannelRequest.AuthSetting authSetting = new SeminarCreateChannelRequest.AuthSetting();
            authSetting.setRank(1)
                    .setEnabled(SeminarConstant.Flag.YES.getFlag())
                    .setAuthType(SeminarConstant.AuthType.CODE.getCode())
                    .setAuthCode("123");
            seminarCreateChannelRequest.setBasicSetting(basicSetting).setAuthSettings(Arrays.asList(authSetting));
            seminarCreateChannelResponse = new SeminarChannelServiceImpl().createChannel(seminarCreateChannelRequest);
            Assert.assertNotNull(seminarCreateChannelResponse);
            if (seminarCreateChannelResponse != null) {
                //to do something ......
                log.debug("测试创建研讨会频道(旧版后台)成功 {}", JSON.toJSONString(seminarCreateChannelResponse));
                //TODO 此处创建完成后删除了频道，正式使用需删除该语句
                super.deleteChannel(seminarCreateChannelResponse.getChannelId());
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 SeminarCreateChannelResponse 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求入參說明

BasicSetting參數描述

AuthSetting參數描述

InfoField參數描述

回傳物件描述

2、建立研討會頻道（新版後台）

描述

根据直播默认模板创建频道
接口地址（仅做说明使用）：https://api.polyv.net/live/v4/channel/create

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testCreateChannelV2() throws IOException, NoSuchAlgorithmException {
        SeminarCreateChannelV2Request seminarCreateChannelV2Request = new SeminarCreateChannelV2Request();
        SeminarCreateChannelV2Response seminarCreateChannelV2Response;
        try {
            seminarCreateChannelV2Request.setName("测试SDK创建研讨会")
                    .setSeminarHostPassword(super.getRandomString(6))
                    .setSeminarAttendeePassword(super.getRandomString(8))
                    .setCategoryId(super.getCategory())
                    .setStartTime(super.getDate(System.currentTimeMillis() + 600 * 1000))
                    .setLinkMicLimit(15);
            seminarCreateChannelV2Response = new SeminarChannelServiceImpl().createChannelV2(
                    seminarCreateChannelV2Request);
            Assert.assertNotNull(seminarCreateChannelV2Response);
            if (seminarCreateChannelV2Response != null) {
                //to do something ......
                log.debug("测试创建研讨会频道(新版后台)成功 {}", JSON.toJSONString(seminarCreateChannelV2Response));
                //TODO 此处创建完成后删除了频道，正式使用需删除该语句
                super.deleteChannel(String.valueOf(seminarCreateChannelV2Response.getChannelId()));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 SeminarCreateChannelV2Response 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求入參說明

回傳物件描述

3、取得研討會頻道錄製設定

描述

获取研讨会频道录制设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/seminar/setting/get-record

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testGetRecordSetting() throws IOException, NoSuchAlgorithmException {
        SeminarGetRecordSettingRequest seminarGetRecordSettingRequest = new SeminarGetRecordSettingRequest();
        SeminarGetRecordSettingResponse seminarGetRecordSettingResponse;
        try {
            String channelId = super.getChannelId();
            seminarGetRecordSettingRequest.setChannelId(channelId);
            seminarGetRecordSettingResponse = new SeminarChannelServiceImpl().getRecordSetting(
                    seminarGetRecordSettingRequest);
            Assert.assertNotNull(seminarGetRecordSettingResponse);
            if (seminarGetRecordSettingResponse != null) {
                //to do something ......
                log.debug("测试获取研讨会频道录制设置成功 {}", JSON.toJSONString(seminarGetRecordSettingResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 SeminarGetRecordSettingResponse 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因：invalid signature. ]

請求入參說明

回傳物件描述

4、修改研討會頻道錄製設定

描述

修改研讨会频道录制设置
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/seminar/setting/set-record

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testSetRecordSetting() throws IOException, NoSuchAlgorithmException {
        SeminarSetRecordSettingRequest seminarSetRecordSettingRequest = new SeminarSetRecordSettingRequest();
        Boolean seminarSetRecordSettingResponse;
        try {
            String channelId = super.getChannelId();
            seminarSetRecordSettingRequest.setChannelId(channelId)
                    .setRecordMode(SeminarConstant.RecordMode.manual.getModel())
                    .setEnabled(SeminarConstant.Flag.YES.getFlag());
            seminarSetRecordSettingResponse = new SeminarChannelServiceImpl().setRecordSetting(
                    seminarSetRecordSettingRequest);
            Assert.assertTrue(seminarSetRecordSettingResponse);
            if (seminarSetRecordSettingResponse) {
                //to do something ......
                log.debug("测试修改研讨会频道录制设置成功");
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 Boolean 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因：invalid signature. ]

請求入參說明

回傳物件描述

修改研討會頻道錄製設定返回實體

5、取得研討會直播間與會者統計資料

描述

获取研讨会直播间参会者统计数据
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/seminar/statistics/listViewLogs

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testGetViewLog() throws IOException, NoSuchAlgorithmException {
        SeminarGetViewLogRequest seminarGetViewLogRequest = new SeminarGetViewLogRequest();
        SeminarGetViewLogResponse seminarGetViewLogResponse;
        try {
            String channelId = super.getChannelId();
            seminarGetViewLogRequest.setChannelId(channelId)
                    .setStartTime(super.getDate(System.currentTimeMillis() - 20 * 86400000))
                    .setEndTime(super.getDate(System.currentTimeMillis()))
                    .setPageSize(20)
                    .setCurrentPage(1);
            seminarGetViewLogResponse = new SeminarChannelServiceImpl().getViewLog(seminarGetViewLogRequest);
            Assert.assertNotNull(seminarGetViewLogResponse);
            if (seminarGetViewLogResponse != null) {
                //to do something ......
                log.debug("测试获取研讨会直播间参会者统计数据成功 {}", JSON.toJSONString(seminarGetViewLogResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳SeminarGetViewLogResponse物件，B端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請參閱 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求入參描述

回傳物件描述

ViewLog參數描述

6、取得直播間觀眾統計資料

描述

获取直播间观众统计数据
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/statistics/listViewLogs

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testGetCdnViewLog() throws IOException, NoSuchAlgorithmException {
        SeminarGetCdnViewLogRequest seminarGetCdnViewLogRequest = new SeminarGetCdnViewLogRequest();
        SeminarGetCdnViewLogResponse seminarGetCdnViewLogResponse;
        try {
            String channelId = super.getChannelId();
            seminarGetCdnViewLogRequest.setChannelId(channelId)
                    .setStartTime(super.getDate(System.currentTimeMillis() + 600 * 1000))
                    .setEndTime(super.getDate(System.currentTimeMillis() + 600 * 1000));
            seminarGetCdnViewLogResponse = new SeminarChannelServiceImpl().getCdnViewLog(seminarGetCdnViewLogRequest);
            Assert.assertNotNull(seminarGetCdnViewLogResponse);
            if (seminarGetCdnViewLogResponse != null) {
                //to do something ......
                log.debug("测试获取直播间观众统计数据成功 {}", JSON.toJSONString(seminarGetCdnViewLogResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳SeminarGetCdnViewLogResponse物件，B端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請參閱 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求入參描述

回傳物件描述

ViewLog參數描述

7、刪除單一頻道

描述

删除单个直播频道
接口地址（仅做说明使用）：https://api.polyv.net/live/v2/channels/%s/delete

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testDeleteChannel() throws IOException, NoSuchAlgorithmException {
        SeminarDeleteChannelRequest seminarDeleteChannelRequest = new SeminarDeleteChannelRequest();
        Boolean seminarDeleteChannelResponse;
        try {
            seminarDeleteChannelRequest.setChannelId("2801915");
            seminarDeleteChannelResponse = new SeminarChannelServiceImpl().deleteChannel(seminarDeleteChannelRequest);
            Assert.assertTrue(seminarDeleteChannelResponse);
            if (seminarDeleteChannelResponse) {
                //to do something ......
                log.debug("测试删除单个频道成功");
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 Boolean 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因：invalid signature. ]

請求入參說明

回傳物件描述

刪除單個頻道返回實體

8、批次刪除頻道

描述

批量删除直播频道，如果响应失败，则表示全部频道都失败，不会有部份成功、部份失败的结果
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/basic/batch-delete

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testBatchDeleteChannel() throws IOException, NoSuchAlgorithmException {
        SeminarBatchDeleteChannelRequest seminarBatchDeleteChannelRequest = new SeminarBatchDeleteChannelRequest();
        Boolean seminarBatchDeleteChannelResponse;
        try {
            seminarBatchDeleteChannelRequest.setChannelIds(Arrays.asList("2802164", "2798162"));
            seminarBatchDeleteChannelResponse = new SeminarChannelServiceImpl().batchDeleteChannel(
                    seminarBatchDeleteChannelRequest);
            Assert.assertTrue(seminarBatchDeleteChannelResponse);
            if (seminarBatchDeleteChannelResponse) {
                //to do something ......
                log.debug("测试批量删除频道成功");
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 Boolean 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求參數說明

回傳物件描述

批次刪除頻道回傳實體

9、查詢研討會會議類型

描述

查询研讨会会议类型
接口地址（仅做说明使用）：https://api.polyv.net/meet/v1/channel/live-type/get

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testGetLiveType() throws IOException, NoSuchAlgorithmException {
        SeminarGetLiveTypeRequest seminarGetLiveTypeRequest = new SeminarGetLiveTypeRequest();
        SeminarGetLiveTypeResponse seminarGetLiveTypeResponse;
        try {
            String channelId = super.getChannelId();
            seminarGetLiveTypeRequest.setChannelId(channelId);
            seminarGetLiveTypeResponse = new SeminarChannelServiceImpl().getLiveType(seminarGetLiveTypeRequest);
            Assert.assertNotNull(seminarGetLiveTypeResponse);
            if (seminarGetLiveTypeResponse != null) {
                //to do something ......
                log.debug("测试查询研讨会会议类型成功 {}", JSON.toJSONString(seminarGetLiveTypeResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 SeminarGetLiveTypeResponse 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求參數說明

回傳物件描述

10、修改研討會會議類型

描述

修改研讨会会议类型
接口地址（仅做说明使用）：https://api.polyv.net/meet/v1/channel/live-type/update

呼叫限制

1、介面呼叫有頻率限制，詳細請查看，呼叫常見異常，詳細請查看

單元測試

    @Test
    public void testUpdateLiveType() throws IOException, NoSuchAlgorithmException {
        SeminarUpdateLiveTypeRequest seminarUpdateLiveTypeRequest = new SeminarUpdateLiveTypeRequest();
        Boolean seminarUpdateLiveTypeResponse;
        try {
            String channelId = super.getChannelId();
            seminarUpdateLiveTypeRequest.setChannelId(channelId);
            seminarUpdateLiveTypeRequest.setSeminarLiveType("private");
            seminarUpdateLiveTypeResponse = new SeminarChannelServiceImpl().updateLiveType(
                    seminarUpdateLiveTypeRequest);
            Assert.assertNotNull(seminarUpdateLiveTypeResponse);
            if (seminarUpdateLiveTypeResponse != null) {
                //to do something ......
                log.debug("测试修改研讨会会议类型成功 {}", JSON.toJSONString(seminarUpdateLiveTypeResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

單元測試說明

1、請求正確，回傳 Boolean 物件，B 端依據此物件處理業務邏輯；

2、請求參數驗證不合格，拋出 PloyvSdkException，錯誤訊息請見 PloyvSdkException.getMessage()，例如 [ 輸入參數 [xxx.chat.LivexxxRequest] 物件驗證失敗，失敗欄位 [pic 不能為空 / msg 不能為空] ]

3、伺服器處理異常，拋出 PloyvSdkException，錯誤資訊請見 PloyvSdkException.getMessage()，例如 [ 保利威請求回傳資料錯誤，請求流水號：66e7ad29fd04425a84c2b2b562d2025b，錯誤原因： invalid signature. ]

請求入參描述

回傳物件描述

修改研討會會議類型返回實體