文档中心
灵动课堂
Agora.io 社区
中文
search-icon
配置 aPaaS 服务
更新时间 2021/07/29 09:16:22

使用 Agora 灵动课堂前，你需要先在 Agora 控制台配置 aPaaS 服务。

前提条件

配置 aPaaS 服务前，请确保已经具备以下条件：

配置 aPaaS 服务

参照以下步骤在 Agora 控制台配置 aPaaS 服务。

  1. 登录 Agora 控制台，进入项目管理页面。点击 Agora 项目的编辑按钮进入项目编辑页面，然后点击 aPaaS 配置按钮。

    项目管理页面

  2. 在 aPaaS 配置页面，勾选白板和云端录制选择框后，将下文的 JSON 对象示例分别粘贴至编辑框并替换相应参数以配置白板和云端录制功能，然后点击更新。

    白板 JSON 示例：

    你需要将 appId 替换成你的白板 App Identifier，将 token 替换成你的白板 SDK Token。点击此处查看字段详细介绍。
 {
          "appId": "<your_whiteboard_app_id>",
          "token": "<your_whiteboard_sdk_token>",
          "oss": {
              "region": "oss-cn-shanghai",
              "bucket": "your-bucket-name",
              "folder": "whiteboard",
              "accessKey": "your-access-key",
              "secretKey": "your-secret-key",
              "endpoint": "oss-cn-shanghai.aliyuncs.com"
          }
  }

录制 JSON 示例：

点击此处查看字段详细介绍。
  {
          "recordingConfig": {},
          "storageConfig": {}
  }

配置成功后，你可以看到以下页面：

后续步骤

在 Agora 控制台配置 aPaaS 服务后，你可参考《启动课堂》文档使用 Agora Classroom SDK 加入一个灵动课堂。

更多信息

白板 JSON 配置对象介绍

白板的 JSON 配置对象包含以下字段：

字段 类型 描述
appId String （必填）你的白板 App Identifier。如不设置，则无法进入灵动课堂。
token String （必填）你的白板 SDK Token。如不设置，则无法进入灵动课堂。
oss Object （选填）阿里云 OSS 配置，用于储存你在课堂中上传的课件。如不设置，则无法使用白板中的课件上传功能。

注意事项：当前白板只支持阿里云 OSS。

JSON 对象包含以下字段：

  • region: String 型，阿里云 OSS 指定的地区信息，例如 "oss-cn-shanghai"。
  • bucket: String 型，阿里云 OSS 的 Bucket 名称，例如 "agora-whiteboard"。
  • folder: String 型，阿里云 OSS 中的资源路径，例如 "whiteboard"。
  • accessKey：String 型，阿里云访问密钥 AccessKey 中的 AccessKeyId，详见阿里云文档。仅适用于灵动课堂 1.1.0 之前版本。
  • secretKey：String 型，阿里云访问密钥 AccessKey 中的 AccessKeySecret，详见阿里云文档。仅适用于灵动课堂 1.1.0 之前版本。
  • endpoint: String 型，阿里云 OSS 访问域名，例如 "oss-cn-shanghai.aliyuncs.com"。
  • ramAccessKey: String 型，阿里云临时访问密钥 STS AK 的 AccessKeyId。详见阿里云文档。仅适用于灵动课堂 1.1.0 及之后版本。
  • ramAccessSecret: String 型，阿里云临时访问密钥 STS AK 的 AccessKeySecret，详见阿里云文档。仅适用于灵动课堂 1.1.0 及之后版本。
  • roleArn: String 型，阿里云 OSS 临时授权访问的角色 ARN，详见阿里云文档。仅适用于灵动课堂 1.1.0 及之后版本。
  • roleSessionName: （必填）String 型，阿里云 OSS 标识临时访问凭证的名称，详见阿里云文档。仅适用于灵动课堂 1.1.0 及之后版本。

录制 JSON 配置对象参数介绍

录制的 JSON 配置对象包含以下字段：

字段 类型 描述
recordingConfig Object （选填）录制设置。如不设置，则使用合流录制模式且只录制老师的音视频。如需更改录制行为，请参考云端录制设置。
storageConfig Object （选填）云存储设置，用于储存你的录制文件。如不设置，你的录制文件会存储在 Agora 的阿里云 OSS 账号中。如需使用你自己的云存储，请参考云存储设置进行配置。请注意以下字段的设置：
  • endpoint : （必填）String 类型，由阿里云 Bucket 名称和访问域名拼成的完整路径。假设你的 Bucket 名称为 "agora-recording"，阿里云 OSS 访问域名为 "oss-cn-shanghai.aliyuncs.com"，则 endpoint 字段设为 "https://agora-recording.oss-cn-shanghai.aliyuncs.com"。
  • fileNamePrefix: （选填）String 数组，指定录制文件在第三方云存储中的存储位置。你可使用变量来指定一个动态路径。你发起录制时，灵动课堂云服务会用真实的值替换变量。详见如何指定动态存储路径。
    		•
    score