开启和配置互动白板服务

使用声网互动白板服务前，你需要先在声网控制台开启并配置互动白板服务。

前提条件

开启互动白板服务前，请确保已经具备以下条件：

• 有效的声网开发者账号。如果有 Netless 账号，必须先完成 Netless 账号下的项目迁移。
• 启用中的声网控制台项目。如果你还没有创建过项目，参考创建和管理项目。

开启互动白板服务

按照以下步骤，在声网控制台开启互动白板服务：

1. 登录声网控制台，点击左侧导航栏的项目管理。

2. 在项目管理页面，选择需要开通互动白板服务的项目，点击配置。
   

3. 在实时互动拓展能力下，找到白板，点击开启。
   

4. 仔细阅读弹窗提示，点击确认。成功开启后，开启按钮会切换为配置按钮，用于配置白板服务。
   

获取互动白板项目的安全密钥

声网控制台会给每个开启互动白板服务的项目分配以下安全密钥：

• AppIdentifier：项目的 App Identifier，即项目的唯一标识。初始化白板 SDK 时需要传入 App Identifier。
• AK 和 SK：访问密钥对，用于生成互动白板 Token。详见在 app 服务端生成 Token 。
• SDK Token：声网控制台生成的 SDK Token（动态密钥），用于你的项目测试。在生产环境中，你需要使用示例代码或调用服务端 RESTful API ，在自己的 app 服务端生成 SDK Token。

按照以下步骤获取安全密钥：

1. 在声网控制台的项目管理页面，找到已开启互动白板服务的项目，点击编辑。
2. 在编辑项目页面，找到白板，点击配置。
3. 在基本信息下面，点击右侧的眼睛图标，分别复制白板项目的 App Identifier、AK 和 SK，并保存到安全的位置。
   
4. 点击生成sdk Token，仔细阅读弹窗提示，然后点击复制 sdkToken。复制后，将 SDK Token 保存到安全的位置。
   

开启互动白板配套服务

声网互动白板设立五个数据中心，每个数据中心在服务端提供以下配套服务：

• 文档转换，包括文档转图片和文档转网页。开启文档转换服务后，你可以调用文档转换 RESTful API 发起文档转换任务、查询转换进度。声网会对文档转换服务收取费用，详见计费说明。

• 截图。开启截图服务后，你可以调用截图管理 RESTful API 进行截图。

按照以下步骤在指定数据中心开启配套服务和配置存储空间：

1. 进入声网控制台的项目管理页面，选择已开通互动白板服务的项目，点击编辑。

2. 在编辑项目页面，找到白板，点击配置。

3. 在配套服务下，选择数据中心，点击配置。该数据中心必须与你调用创建房间 API 时在 region 字段中填入的数据中心一致；否则，服务配置不生效。
   

4. 在服务配置下，找到文档转图片、文档转网页或截图，选择已启用。
   

5. 设置存储空间：

   • 点击存储方框右侧的箭头，在下拉列表中选择你已配置的第三方存储空间。
   • 点击创建，新增一个存储空间配置。你需要填写以下信息：
     • 名称：（必填）存储空间的名称。
     • 供应商：（必填）第三方云存储服务的供应商。
     • 区域：（必填）创建 Bucket 时指定的数据中心所在区域。
     • accessKey：（必填）存储服务供应商提供的访问密钥中的 Access Key，用于识别访问者的身份。
     • secretKey：（必填）存储服务供应商提供的访问密钥中的 Secret Key，用于验证签名的密钥。
     • bucket：（必填）Bucket 的名称。
     • 存储路径：资源在 Bucket 中的存放路径，默认为根目录。
     • 外链域名：对外服务的访问域名。如果使用七牛云 OSS，该字段为必填，否则声网将无法访问该存储服务内的资源。该字段必须包含协议头，比如 https:// 或 http://。
   • 要获取第三方存储空间的配置信息，请参考对应的云存储服务供应商的官方文档。
   • 第三方存储空间应开启公共读或更高权限，以确保你的 app 客户端可以访问其中的文件。

6. 点击保存，仔细阅读弹窗提示后点击确定。

相关文档

• 加入白板房间（Web）
• 加入白板房间（Android）
• 加入白板房间（iOS）
• 文档转换服务