本文介绍如何在 Agora 控制台配置灵动课堂中的互动白板、实时录制和实时消息功能。
如需在灵动课堂中上传 PPT、Word、PDF 等课件并在课堂白板上展示,你需要在 Agora 控制台配置灵动课堂中的互动白板功能。
互动白板功能使用第三方云存储服务储存在课堂中上传的文件。因此,使用互动白板功能前,请确保你已开通第三方云存储服务。Agora 当前支持阿里云 OSS 和 Amazon S3。
在灵动课堂配置页面,找到白板模块,如下图所示:
你需要进行以下操作:
配置第三方云存储信息用于储存在课堂中上传的文件。
如果你使用阿里云 OSS,填写以下信息:
region
: 阿里云 OSS 中创建 Bucket 时指定的数据中心所在区域,例如 oss-cn-shanghai
。endpoint
: 阿里云 OSS 的访问域名,例如 oss-cn-shanghai.aliyuncs.com
。bucket
: 阿里云 OSS 中的 Bucket 名称,例如 agora-whiteboard
。folder
: 阿里云 OSS 中的资源存放路径,例如 whiteboard
。accessKey
: 阿里云 OSS 提供的访问密钥中的 Access Key,用于识别访问者的身份。secretKey
: 阿里云 OSS 提供的访问密钥中的 Secret Key,用于验证签名的密钥。如果你使用 Amazon S3,填写以下信息:
region
: Amazon S3 中创建 Bucket 时指定的数据中心所在区域。endpoint
: Amazon S3 的访问域名。bucket
: Amazon S3 中的 Bucket 名称。folder
: Amazon S3 中的资源存放路径,例如 agora-whiteboard
。accessKey
: Amazon S3 提供的访问密钥中的 Access Key,用于识别访问者的身份。secretKey
: Amazon S3 提供的访问密钥中的 Secret Key,用于验证签名的密钥。开启文档转网页、文档转图片、截图等白板进阶服务。参考开启互动白板配套服务。
灵动课堂中默认录制行为是:使用合流录制模式且只录制老师的音视频,录制文件会存储在 Agora 的阿里云 OSS 账号中。
如需修改上述行为,你可在 Agora 控制台灵动课堂配置页面找到云录制模块,分别传入 JSON 对象进行配置:
传入 recordingConfig
JSON 对象。参考 recordingConfig 介绍。
recordingConfig
JSON 对象示例:
{
"maxIdleTime": 30,
"streamTypes": 2,
"channelType": 0
}
传入 storageConfig
JSON 对象用于存储录制文件。参考 storageConfig 介绍,请注意以下字段的设置:
endpoint
:(必填)String 类型,由 Bucket 名称和访问域名拼成的完整路径。假设你的 Bucket 名称为 "agora-recording"
,OSS 访问域名为 "oss-cn-shanghai.aliyuncs.com"
,则 endpoint
字段设为 "https://agora-recording.oss-cn-shanghai.aliyuncs.com"
。fileNamePrefix
:(选填)String 数组,指定录制文件在第三方云存储中的存储位置。你可使用变量来指定一个动态路径。你发起录制时,灵动课堂云服务会用真实的值替换变量。详见如何指定动态存储路径。storageConfig
JSON 对象示例:
{
"vendor": 2,
"region": 3,
"bucket": "xxxxx",
"accessKey": "xxxxxxf",
"secretKey": "xxxxx",
"endpoint": "https://agora-recording.oss-cn-shanghai.aliyuncs.com",
"fileNamePrefix": [
"scenario",
"recording"
]
}
灵动课堂集成了环信 IM SDK 实现实时消息功能。因此,如需使用灵动课堂中的实时消息功能,你需要进行以下操作:
注册环信即时通讯云。
在环信开发者管理后台创建应用,参考创建应用。
在环信开发者管理后台获取以下信息后填写在 Agora 控制台灵动课堂配置页面中。
apiHost
:(必填)环信 REST API 访问地址,例如 a1.easemob.com 或 a1.easecdn.com,你可在环信开发者管理后台获取。orgName
:(必填)企业的唯一标识,你在环信开发者管理后台注册账号时填写的企业 ID。appName
:(必填)企业下 App 的唯一标识,你在环信开发者管理后台创建应用时填写的应用名称。superAdmin
:(必填)超级管理员用户名前缀。只支持数字或字母,不支持特殊字符,aPaaS 会以 ${superAdmin}-${timestamp}
作为超级管理员创建 IM 房间。appKey
:(必填)App 的唯一标识,由环信开发者管理后台基于 ${org_name}#${app_name}
的规则生成。clientId
:(必填)开发者 Client ID,由环信开发者管理后台生成。clientSecret
:(必填)开发者密钥,由环信开发者管理后台生成。你可参考下图获取这些信息。
为确保 Agora 可以访问你的云存储空间,你的云存储账号中必须进行以下配置: