开启和配置互动白板服务
使用声网互动白板服务前,你需要先在声网控制台开启并配置互动白板服务。
前提条件
开启互动白板服务前,请确保已经具备以下条件:
- 有效的声网开发者账号。如果有 Netless 账号,必须先完成 Netless 账号下的项目迁移。
- 启用中的声网控制台项目。如果你还没有创建过项目,参考创建和管理项目。
开启互动白板服务
按照以下步骤,在声网控制台开启互动白板服务:
-
登录声网控制台,点击左侧导航栏的项目管理。
-
在项目管理页面,选择需要开通互动白板服务的项目,点击配置。
-
在实时互动扩展能力下,找到白板,点击开启。
-
仔细阅读弹窗提示,点击确认。成功开启后,开启按钮会切换为配置按钮,用于配置白板服务。
获取互动白板项目的安全密钥
声网控制台会给每个开启互动白板服务的项目分配以下安全密钥:
- AppIdentifier:也称为 App ID,即项目的唯一标识。初始化白板 SDK 时需要传入 AppIdentifier。
- AK 和 SK:访问密钥对,用于生成互动白板 Token。详见获取访问密钥对 。
- sdkToken:声网控制台生成的 SDK Token(动态密钥),一般用于项目测试。在生产环境中,你需要使用示例代码或调用服务端 API,在自己的 app 服务端生成 SDK Token。
按照以下步骤获取安全密钥:
- 在声网控制台的项目管理页面,找到已开启互动白板服务的项目,点击编辑。
- 在编辑项目页面,找到白板,点击配置。
- 在基本信息下面,点击右侧的眼睛图标,分别复制白板项目的 AppIdentifier、AK 和 SK,并保存到安全的位置。
- 点击生成sdk Token,仔细阅读弹窗提示,然后点击复制 sdkToken。复制后,将 SDK Token 保存到安全的位置。
注意
访问密钥对(即 AK 和 SK)一旦泄露,会造成严重的安全问题。为提高项目的安全性,声网建议:
开启互动白板配套服务
声网互动白板设立五个数据中心,每个数据中心在服务端提供以下配套服务:
-
文档转换,包括文档转图片和文档转网页。开启文档转换服务后,你可以调用服务端 API 发起文档转换任务、查询转换进度。声网会对文档转换服务收取费用,详见计费说明。
-
截图。开启截图服务后,你可以调用服务端 API 进行截图。
按照以下步骤在指定数据中心开启配套服务和配置存储空间:
-
在服务配置下,找到文档转图片、文档转网页或截图,选择已启用。
-
设置存储空间:
- 点击存储方框右侧的箭头,在下拉列表中选择你已配置的第三方存储空间。
- 点击创建,新增一个存储空间配置。你需要填写以下信息:
- 名称:(必填)存储空间的名称。
- 供应商:(必填)第三方云存储服务的供应商。
- 区域:(必填)创建 Bucket 时指定的数据中心所在区域。
- accessKey:(必填)存储服务供应商提供的访问密钥中的 Access Key,用于识别访问者的身份。
- secretKey:(必填)存储服务供应商提供的访问密钥中的 Secret Key,用于验证签名的密钥。
- bucket:(必填)Bucket 的名称。
- 存储路径:资源在 Bucket 中的存放路径,默认为根目录。
- 外链域名:对外服务的访问域名。如果使用七牛云 OSS,该字段为必填,否则声网将无法访问该存储服务内的资源。该字段必须包含协议头,比如
https://
或http://
。
注意
- 要获取第三方存储空间的配置信息,请参考对应的云存储服务供应商的官方文档。
- 第三方存储空间应开启公共读或更高权限,以确保你的 App 客户端可以访问其中的文件。
- 点击保存,仔细阅读弹窗提示后点击确定。