配置智能云会议

更新时间不可用

了解智能云会议中配置智能云会议相关内容的适用场景、配置步骤、实现要点和注意事项。

在声网控制台中开通智能云会议后,你可以参考本文在控制台中进一步配置智能云会议的高频使用功能:

  • 互动白板。
  • 云端录制。
  • 环信即时通讯 IM。

配置互动白板

前提条件

互动白板功能使用第三方云存储服务储存会议中上传的文件。因此,使用互动白板功能前,请确保你已开通第三方云存储服务,并设置声网可访问该云存储空间。操作步骤如下:

  1. 参考云存储官方文档开通服务。声网当前支持如下第三方云存储服务,你可以任选一种:

  2. 如果你使用阿里云 OSS 或 Amazon S3,那么在你使用的云存储账号中进行如下配置,以确保声网可以访问你的云存储空间:

操作步骤

  1. 在声网控制台的灵动会议配置页面,找到白板模块:
  1. 在白板模块中,填写你使用的第三方云存储相关参数,用于储存会议中上传的文件:

    参数描述
    vendor选择你使用的云存储服务。
    region你的云存储服务中创建 Bucket 时指定的数据中心所在区域。例如:oss-cn-shanghai。
    endpoint你的云存储服务的访问域名。例如:oss-cn-shanghai.aliyuncs.com。
    bucket你的云存储服务中的 Bucket 名称。例如:agora-whiteboard。
    folder你的云存储服务中的资源存放路径。例如:whiteboard。
    accessKey你的云存储服务提供的访问密钥中的 Access Key,用于识别访问者的身份。
    secretKey你的云存储服务提供的访问密钥中的 Secret Key,用于验证签名的密钥。
    表格内容超出当前宽度,可横向滚动查看更多列。

    以上参数均为字符串类型,获取方式可参考你使用的云存储服务官方文档。

  2. (可选)如果你需要在会议里使用 PPT、DOC、PDF 等格式的文件,你还需要开启并配置互动白板中的进阶功能:文档转网页、文档转图片、截图。点击进阶服务下方的前往配置,参考开启互动白板配套服务操作。

配置云端录制

在智能云会议中,默认录制会议中主持人的发言。具体的录制配置如下:

配置项默认行为是否支持自定义
录制模式使用合流录制模式。不支持自定义。
录制配置只录制会议中主持人的音视频。是,可按需修改。
存储配置录制文件会存储在声网使用的阿里云 OSS 账号中。是,且必须修改,否则录制文件无法存储到你的 OSS 账号中。
表格内容超出当前宽度,可横向滚动查看更多列。

如需修改默认录制配置,可以在声网控制台的灵动会议配置页面找到云端录制模块。点击自定义,并填写 JSON 代码来修改录制配置和存储配置。

录制配置

录制配置的 JSON 代码为云端录制 API 中的 recordingConfig 对象。你可以参考云端录制 API 中 recordingConfig 描述。

录制配置 JSON 填写示例

JSON
{
  "maxIdleTime": 30,
  "streamTypes": 2,
  "channelType": 0
}

存储配置

存储配置的 JSON 代码为云端录制 API 中的 storageConfig 对象。你可以参考云端录制 API 中 storageConfig 描述。

存储配置 JSON 填写示例

JSON
{
  "vendor": 2,
  "region": 3,
  "bucket": "{your_bucket}",
  "accessKey": "{your_access_key}",
  "secretKey": "{your_secret_key}",
  "endpoint": "https://agora-recording.oss-cn-shanghai.aliyuncs.com",
  "fileNamePrefix": [
    "scenario",
    "recording"
  ]
}

storageConfig 对象中重要字段说明:

字段类型描述备注
endpoint必填 String由 Bucket 名称和访问域名拼成的完整路径。 例如,Bucket 名称为 agora-recording,OSS 访问域名为 oss-cn-shanghai.aliyuncs.com,则 endpoint 字段应设为 https://agora-recording.oss-cn-shanghai.aliyuncs.com。
  • 该字段会应用在查询录制列表返回的 url 字段里的地址域名。
  • 如果你的 OSS 配置了 CDN 加速,也可以直接将 endpoint 设置为 CDN 加速域名,最终录制页面的 URL 为 https://agora-adc-artifacts.oss-accelerate.aliyuncs.com/xxxxx.mp4。
fileNamePrefix选填 String 数组

录制文件在第三方云存储中的存储位置,与录制文件名前缀有关。

如果设为 ["directory1","directory2"],那么录制文件名前缀为 "directory1/directory2/",即录制文件名为 directory1/directory2/xxx.m3u8。

前缀长度(包括斜杠)不得超过 128 个字符。字符串中不得出现斜杠、下划线、括号等符号字符。以下为支持的字符集范围:

  • 26 个小写英文字母 a-z
  • 26 个大写英文字母 A-Z
  • 10 个数字 0-9
你可使用变量来指定一个动态路径。你发起录制时,智能云会议云服务会用真实的值替换变量。详见如何指定动态存储路径。
表格内容超出当前宽度,可横向滚动查看更多列。

配置环信 IM

智能云会议集成了实时消息 RTM SDK 和即时通讯环信 IM SDK 来实现信令和实时消息功能。RTM 无需你手动配置,IM 需要你自行配置。IM 配置步骤如下:

  1. 注册环信即时通讯云。

  2. 在环信开发者管理后台创建应用,详见创建应用。

    信息

    环信开发者管理后台中,应用的服务类型默认为免费社区版,只能创建 100 个用户,仅用于体验与集成目的。若有生产环境需求,需联系销售开通企业版。

  3. 在环信开发者管理后台获取如下参数信息:

    参数描述
    apiHost环信 REST API 访问地址。例如 a1.easemob.com 或 a1.easecdn.com。
    orgName企业的唯一标识,你在环信开发者管理后台注册账号时填写的企业 ID。
    appName企业下 App 的唯一标识,你在环信开发者管理后台创建应用时填写的应用名称。
    superAdmin超级管理员用户名前缀。
    appKeyApp 的唯一标识,由环信开发者管理后台基于 ${org_name}#${app_name} 的规则生成。
    clientId开发者 Client ID,由环信开发者管理后台生成。
    clientSecret开发者密钥,由环信开发者管理后台生成。
    表格内容超出当前宽度,可横向滚动查看更多列。

    注意

    superAdmin(超级管理员用户名前缀)只支持数字或字母,不支持特殊字符,智能云会议将以 ${superAdmin}-${timestamp} 作为超级管理员创建 IM 房间。

  1. 将上一步获取的 IM 参数信息填写到声网控制台灵动会议配置页面的环信 IM 模块中。