概述 - 钉钉 API

本文介绍了什么是直播以及直播开放接口等。

什么是直播

钉钉直播具有直播预约、权限自由设置、多群联播、实时互动、直播录制、直播数据统计等完善功能，打破时间和空间上的限制，方便的完成一场直播活动，高效上传下达，改变传统培训管理模式。

对于企业培训、招聘宣讲、活动直播、在线课堂等多种场景，钉钉直播能够轻松搞定，同时提供专业的重保服务，确保现场执行团队顺利部署及调试设备，保障直播线上到线下的整体质量和体验。

亮点功能

直播预约：可提前获得直播链接进行宣传，打通钉钉日历，开播前进行提醒。

权限自由设置：主播可设置直播为公开可见或企业内可见。

多群联播：轻松将单场直播同步到多个群。

实时互动：指出连麦、聊天、点赞、签到、答题等丰富的互动形式。

直播录制：自动保存直播录像，方便直播内容沉淀和二次传播。

直播数据统计观看人数、观看时长等数据精细记录，直播培训效果可衡量。

如何发起直播

在钉钉PC客户端页面，单击客户端左侧更多，依次单击直播 > 发起直播。

直播接口能力

直播开放的接口列表

直播提供了丰富的开放接口，开发者通过API接口可以实现钉钉直播原生能力调用。

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
创建直播	创建直播。	创建直播	-
查询直播信息	根据直播ID查询直播信息。	查询直播信息	-
修改直播属性信息	修改直播属性信息。	修改直播属性信息	-
查询直播的观看数据	查询直播的观看数据。	查询直播的观看数据	-
查询直播观看人员信息	查询直播观看人员的具体观看信息。	查询直播观看人员信息	-
删除直播	删除直播。	删除直播	-

直播回调事件列表

直播支持状态变化、修改信息和观看回放信息回调事件。

直播事件

名词解释

自定义封面

直播封面，可上传自定义的直播封面图片。

添加直播群

直播开始后，自动发送开播提醒通知至添加的直播群。

直播ID

每个直播有唯一的直播ID，定义为liveId。可调用创建直播接口获取liveId参数值。

观看人数

观看直播人数，不包括主持人，定义为liveUv。

概述

什么是直播#

亮点功能#

如何发起直播#

直播接口能力#

直播开放的接口列表#

直播回调事件列表#

名词解释#

自定义封面#

添加直播群#

直播ID#

观看人数#

#