配置灵动课堂服务
本文介绍如何在声网控制台配置灵动课堂中的互动白板、实时录制和实时消息功能。
配置白板功能
如需在灵动课堂中上传 PPT、Word、PDF 等课件并在课堂白板上展示，你需要在声网控制台配置灵动课堂中的互动白板功能。
前提条件
互动白板功能使用第三方云存储服务储存在课堂中上传的文件。因此，使用互动白板功能前，请确保你已开通第三方云存储服务。声网当前支持阿里云 OSS、Amazon S3、华为云 OSS 和腾讯云 OSS。
操作步骤
在灵动课堂配置页面，找到白板模块，如下图所示：
你需要进行以下操作：
配置第三方云存储信息用于储存在课堂中上传的文件。
如果你使用阿里云 OSS，填写以下信息：
region: 阿里云 OSS 中创建 Bucket 时指定的数据中心所在区域，例如oss-cn-shanghai。endpoint: 一般是由 Bucket 名称和访问域名拼成的完整路径。例如，你的 Bucket 名称为 "agora-recording"，OSS 访问域名为 "oss-cn-shanghai.aliyuncs.com"，则endpoint字段需要设为 "https://agora-recording.oss-cn-shanghai.aliyuncs.com"。该字段会应用在[查询录制列表]（agora_class_restful_api#%E6%9F%A5%E8%AF%A2%E5%BD%95%E5%88%B6%E5%88%97%E8%A1%A8）接口返回的url字段里的地址的域名。如果你的 OSS 配置了 CDN 加速，也可以直接将endpoint设置为 CDN 加速域名，最终录制页面的 URL 为https://agora-adc-artifacts.oss-accelerate.aliyuncs.com/xxxxx.mp4。bucket: 阿里云 OSS 中的 Bucket 名称，例如agora-whiteboard。folder: 阿里云 OSS 中的资源存放路径，例如whiteboard。accessKey: 阿里云 OSS 提供的访问密钥中的 Access Key，用于识别访问者的身份。secretKey: 阿里云 OSS 提供的访问密钥中的 Secret Key，用于验证签名的密钥。对于如何获取上述信息，请查看阿里云官方文档。
如果你使用 Amazon S3，填写以下信息：
region: String 型，Amazon S3 中创建 Bucket 时指定的数据中心所在区域。endpoint: String 型，Amazon S3 的访问域名。bucket: String 型，Amazon S3 中的 Bucket 名称。folder: String 型，Amazon S3 中的资源存放路径，例如agora-whiteboard。accessKey: String 型，Amazon S3 提供的访问密钥中的 Access Key，用于识别访问者的身份。secretKey: String 型，Amazon S3 提供的访问密钥中的 Secret Key，用于验证签名的密钥。对于如何获取上述信息，请查看 Amazon S3 官方文档。如果使用华为云 OSS 或者腾讯云 OSS，参考以上信息填写相应的字段即可。
如果你需要在课堂里使用 PPT、DOC、PDF 等格式的课件，你还需要点击进阶服务下方的前往配置，来为灵动课堂开启并配置文档转网页、文档转图片、截图服务。操作步骤详见开启互动白板配套服务。
为确保声网可以访问你的云存储空间，你的云存储账号中必须进行相关配置，详见注意事项。
配置录制功能
灵动课堂中默认录制行为是：使用合流录制模式且只录制老师的音视频，录制文件会存储在声网的阿里云 OSS 账号中。
如需修改上述行为，你可在声网控制台灵动课堂配置页面找到云录制模块，分别传入 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
灵动课堂集成了环信 IM SDK 实现实时消息功能。因此，如需使用灵动课堂中的实时消息功能，你需要进行以下操作：
注册环信即时通讯云。
在环信开发者管理后台创建应用，参考创建应用。
在环信开发者管理后台获取以下信息后填写在声网控制台灵动课堂配置页面中。
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:（必填）开发者密钥，由环信开发者管理后台生成。
你可参考下图获取这些信息。
配置 CDN 推拉流功能
灵动课堂支持 CDN 推拉流功能，即，支持将老师的流（音视频流、白板、或混合了音视频和白板的流）推到一路 CDN 地址，支持学生拉取 CDN 流观看教学。
开通该服务需要你先参考如下操作，再联系技术支持。
登录控制台，在项目管理页面，选择需要开通的项目，点击配置。
在服务配置页面找到融合CDN模块，点击配置， 参考配置融合 CDN 文档完成配置。
返回服务配置页面，找到旁路推流，点击启用。
启用 服务端 RESTful API。启用后不能关闭。
仔细阅读弹窗提示，点击保存。成功开启旁路推流服务后，启用按钮会切换为配置按钮，用于配置旁路推流。
成功开通旁路推流后，启用按钮会变成配置按钮。后续通过点击配置按钮，可以查看或修改具体配置。配置完成后，在服务配置页面选择灵动课堂的配置，在 CDN 配置部份，填入推流域名和拉流域名并保存。
注意事项
为确保声网可以访问你的云存储空间，你的云存储账号中必须进行以下配置：
- 阿里云 OSS 账号：
- 读写权限设为公共读：
- 跨域规则配置：
- 来源和允许 Headers 根据你的实际情况配置即可。
- 暴露 Headers 必须严格参照下图填写。
- 读写权限设为公共读：
- AWS S3 账号的配置参考如下：
- Bucket policy
{ "Version": "2012-10-17", "Id": "Policy1622700880591", "Statement": [ { "Sid": "Stmt1622700872941", "Effect": "Allow", "Principal": "*", "Action": "s3:GetObject", "Resource": "arn:aws-cn:s3:::agora-adc-artifacts/*" } ] } - Cross-origin resource sharing
[ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "PUT", "GET" ], "AllowedOrigins": [ "*" ], "ExposeHeaders": [] } ]
- Bucket policy
如果使用阿里云 OSS，需要在你的阿里云存储账号中增加 oss:PutObject 授权操作，否则上传课件会报 403 错误。设置参考以下截图。更多信息详见阿里云文档 Bucket Policy。
