使用教程：发起及删除直播

本文介绍了发起及删除直播操作流程。

流程简介

本文档展示了，创建一个企业内部应用，使用直播提供的API，实现发起及删除直播的相关流程：

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取应用AppKey和AppSecret。

步骤三：添加接口调用权限。搜索“直播”，申请直播对应的权限。

步骤四：获取应用访问凭证获取企业内部应用的accessToken。调用接口时，通过accessToken鉴权调用者身份。

步骤五：调用直播相关API：

调用服务端API-创建直播接口，获取直播ID**liveId**字段**。**

根据直播**liveId**，调用服务端API-修改直播属性信息接口，实现修改直播基础信息。

根据直播**liveId**，调用服务端API-查询直播信息接口，获取直播详细信息。

根据直播**liveId**，调用服务端API-查询直播的观看数据接口，获取直播观看数据信息。

根据直播**liveId**，调用服务端API-查询直播观看人员信息接口，获取直播观看人员信息。

根据直播**liveId**，调用服务端API-删除直播接口，实现删除直播操作。

步骤一：创建企业内部应用

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

登录开发者后台，创建企业内部应用。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取应用AppKey和AppSecret信息。

步骤三：添加接口权限

添加接口调用权限。搜索“直播”，申请直播对应的权限。

步骤四：获取应用访问凭证accessToken

重要

服务端API差异详情参见新旧版规范服务端API区别。

服务端API接口SDK下载，详情参见服务端SDK下载。

新版服务端API接口SDK下载，详情参见新版服务端SDK下载。

以下接口均使用服务端API接口，SDK下载详情参见新版服务端SDK下载。

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的accessToken。

 public void getAccessToken() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
        GetAccessTokenRequest accessTokenRequest = new GetAccessTokenRequest()
                .setAppKey("din*********hgn")
                .setAppSecret("9G_O************mBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

步骤五：调用直播相关API

调用服务端API-创建直播接口，获取直播ID**liveId**字段**。**

说明

获取直播ID后，拼接以下链接： dingtalk://dingtalkclient/action/start_uniform_live?liveUuid=直播ID，实现进入显示界面。

只有发起直播的主播才能打开本链接。

 public void createLive() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        CreateLiveHeaders createLiveHeaders = new CreateLiveHeaders();
        createLiveHeaders.xAcsDingtalkAccessToken = "accessToken";
        CreateLiveRequest createLiveRequest = new CreateLiveRequest()
                .setUnionId("E9CS6*******7QiEiE")
                .setTitle("测试直播")
                .setIntroduction("测试直播简介")
                .setCoverUrl("https://example/k/钉钉图片1.png")
                .setPreStartTime(1669348228000L)
                .setPreEndTime(1669351828000L);
        try {
            CreateLiveResponse liveWithOptions = client.createLiveWithOptions(createLiveRequest, createLiveHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(liveWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据直播**liveId**，调用服务端API-修改直播属性信息接口，实现修改直播基础信息。

说明

已经开启直播的直播属性信息无法修改。

public void updateLives() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        UpdateLiveHeaders updateLiveHeaders = new UpdateLiveHeaders();
        updateLiveHeaders.xAcsDingtalkAccessToken = "accessToken";
        UpdateLiveRequest updateLiveRequest = new UpdateLiveRequest()
                .setLiveId("d94f0a69-****-****-****-fe85e460fe0d")
                .setUnionId("E9CS6*******7QiEiE")
                .setTitle("live_20221125直播")
                .setIntroduction("测试直播简介")
                .setCoverUrl("https://example/k/钉钉图片1.png")
                .setPreStartTime(1669348228000L)
                .setPreEndTime(1669351828000L);
        try {
            UpdateLiveResponse updateLiveResponse = client.updateLiveWithOptions(updateLiveRequest, updateLiveHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(updateLiveResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据直播**liveId**，调用服务端API-查询直播信息接口，获取直播详细信息。

 public void  LiveInfo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        QueryLiveInfoHeaders queryLiveInfoHeaders = new QueryLiveInfoHeaders();
        queryLiveInfoHeaders.xAcsDingtalkAccessToken = "accessToken";
        QueryLiveInfoRequest queryLiveInfoRequest = new QueryLiveInfoRequest()
                .setLiveId("d94f0a69-****-****-****-fe85e460fe0d")
                .setUnionId("E9CS6*******7QiEiE");
        try {
            QueryLiveInfoResponse queryLiveInfoResponse = client.queryLiveInfoWithOptions(queryLiveInfoRequest, queryLiveInfoHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(queryLiveInfoResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据直播**liveId**，调用服务端API-查询直播的观看数据接口，获取直播观看数据信息。

 public void queryLiveData() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        QueryLiveWatchDetailHeaders queryLiveWatchDetailHeaders = new QueryLiveWatchDetailHeaders();
        queryLiveWatchDetailHeaders.xAcsDingtalkAccessToken = "accessToken";
        QueryLiveWatchDetailRequest queryLiveWatchDetailRequest = new QueryLiveWatchDetailRequest()
                .setLiveId("d94f0a69-****-****-****-fe85e460fe0d")
                .setUnionId("E9CS6*******7QiEiE");
        try {
            QueryLiveWatchDetailResponse queryLiveWatchDetailResponse = client.queryLiveWatchDetailWithOptions(queryLiveWatchDetailRequest, queryLiveWatchDetailHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(queryLiveWatchDetailResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据直播**liveId**，调用服务端API-查询直播观看人员信息接口，获取直播观看人员信息。

 public void  queryUserInfo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        QueryLiveWatchUserListHeaders queryLiveWatchUserListHeaders = new QueryLiveWatchUserListHeaders();
        queryLiveWatchUserListHeaders.xAcsDingtalkAccessToken = "accessToken";
        QueryLiveWatchUserListRequest queryLiveWatchUserListRequest = new QueryLiveWatchUserListRequest()
                .setLiveId("d94f0a69-****-****-****-fe85e460fe0d")
                .setUnionId("E9CS6*******7QiEiE")
                .setPageNumber(0)
                .setPageSize(20);
        try {
            QueryLiveWatchUserListResponse queryLiveWatchUserListResponse = client.queryLiveWatchUserListWithOptions(queryLiveWatchUserListRequest, queryLiveWatchUserListHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(queryLiveWatchUserListResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据直播**liveId**，调用服务端API-删除直播接口，实现删除直播操作。

public void deleteLive() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalklive_1_0.Client client = new com.aliyun.dingtalklive_1_0.Client(config);
        DeleteLiveHeaders deleteLiveHeaders = new DeleteLiveHeaders();
        deleteLiveHeaders.xAcsDingtalkAccessToken = "accessToken";
        DeleteLiveRequest deleteLiveRequest = new DeleteLiveRequest()
                .setLiveId("d94f0a69-****-****-****-fe85e460fe0d")
                .setUnionId("E9CS6*******7QiEiE");
        try {
            DeleteLiveResponse deleteLiveResponse = client.deleteLiveWithOptions(deleteLiveRequest, deleteLiveHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(deleteLiveResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

使用教程：发起及删除直播

流程简介#

**步骤一：**创建企业内部应用#

**步骤二：**获取AppKey和AppSecret#

**步骤三：**添加接口权限#