diff --git "a/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\233\206\346\210\220\346\234\200\344\275\263\345\256\236\350\267\265.md" "b/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\233\206\346\210\220\346\234\200\344\275\263\345\256\236\350\267\265.md" index dba6d3e27a9..957b2bd15fd 100644 --- "a/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\233\206\346\210\220\346\234\200\344\275\263\345\256\236\350\267\265.md" +++ "b/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\233\206\346\210\220\346\234\200\344\275\263\345\256\236\350\267\265.md" @@ -1,4 +1,4 @@ -为了保障录制服务的可靠性,声网建议你在集成云端录制 RESTful API 时注意以下几点: +为了保障录制服务的可靠性,声网建议你在集成、时注意以下几点: ## 保障 REST 服务高可用 @@ -20,7 +20,16 @@ 你可以通过云端录制 RESTful API 来获取录制服务状态。相比于云端录制 RESTful API,[消息通知服务](./cloud_recording_callback_rest)可以作为辅助手段。 -
  • 消息通知服务只能作为辅助手段来获取服务录制状态。不建议你的核心业务逻辑依赖消息通知服务。如果你的业务对该服务强依赖,建议联系技术支持开通冗余消息功能,即接收双路消息通知,降低消息丢失的概率。开通冗余消息功能后,需要你基于 sid 对消息进行去重。冗余消息功能仍然不能保证 100% 的消息到达率。
  • 每个 App ID 每秒钟的请求数(QPS)限制默认为 10 次。请根据你的同时最大并发任务数(PCW)和查询间隔,预估所需的 QPS,并通过提交工单的方式申请调整 QPS 限制。
  • 国内 PCW 限制为 1000,其他地区 PCW 限制为 300。如需提升 PCW 限制,请联系技术支持。
  • +
    消息通知服务只能作为辅助手段来获取服务录制状态。不建议你的核心业务逻辑依赖消息通知服务。如果你的业务对该服务强依赖,建议联系技术支持开通冗余消息功能,即接收双路消息通知,降低消息丢失的概率。开通冗余消息功能后,需要你基于 sid 对消息进行去重。冗余消息功能仍然不能保证 100% 的消息到达率。
    + +### 检查 QPS 和 PCW + +请检查你的 App ID 下使用云端录制服务的最大并发任务数(PCW)和每秒钟的请求数(QPS)没有超出声网限制: + +- PCW:单流录制上限为 1000,合流录制上限为 300,页面录制上限为 300。 +- QPS:10。 + +请根据你的 PCW 和查询间隔,预估所需的 QPS。如果需要提升 QPS 和 PCW,请联系技术支持。 ### 确认录制服务已成功启动 diff --git "a/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\241\265\351\235\242\345\275\225\345\210\266\346\234\200\344\275\263\345\256\236\350\267\265.md" "b/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\241\265\351\235\242\345\275\225\345\210\266\346\234\200\344\275\263\345\256\236\350\267\265.md" index 957db58686d..6e08c6ad508 100644 --- "a/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\241\265\351\235\242\345\275\225\345\210\266\346\234\200\344\275\263\345\256\236\350\267\265.md" +++ "b/markdown/cloud-recording/\346\234\200\344\275\263\345\256\236\350\267\265/\351\241\265\351\235\242\345\275\225\345\210\266\346\234\200\344\275\263\345\256\236\350\267\265.md" @@ -1,5 +1,3 @@ -## 概述 - 页面录制场景下,网络异常等偶然因素可能会造成以下问题: - 无法正常访问待录制页面,如页面加载失败或时间过长。针对该问题,声网提供[页面加载超时检测功能](https://docs.agora.io/cn/cloud-recording/cloud_recording_webpage_load_timeout?platform=RESTful)。 @@ -10,11 +8,8 @@ 为了避免上述问题导致的录制内容与预期不一致,声网建议你按照以下方案保障页面录制的可靠性。 -## 推荐方案 - -你可以参考如下方案来保障页面录制的可靠性。 -### 录制启动时的保障 +## 录制启动时的保障 建议你通过如下步骤确认录制服务已成功启动: @@ -26,7 +21,7 @@ ### 录制页面加载时的保障 -#### 定时检测待录制页面是否加载成功 +### 定时检测待录制页面是否加载成功 开始页面录制前,你需要自行完成待录制页面的检测逻辑,以实现以下方案: 1. 调用 `start` 开始页面录制时,页面录制浏览器访问并加载待录制页面。 2. 页面录制服务执行待录制页面 Javascript 的页面检测逻辑,当页面元素加载符合你的预期时,页面录制服务回调 `sid`(录制周期的唯一标识)通知业务服务端录制服务启动成功。 @@ -34,12 +29,12 @@ -#### 待录制页面加载失败的处理措施 +## 待录制页面加载失败的处理措施 在实现待录制页面检测逻辑的前提下,当待录制页面录制加载失败,业务服务端未收到回调时,声网推荐你重新发起录制请求。 -### 录制异常停止的保障 +## 录制异常停止的保障 开通消息通知服务并订阅 [`71 web_recorder_stopped`](https://docs.agora.io/cn/cloud-recording/cloud_recording_callback_rest?platform=RESTful#a-name71a71-web_recorder_stopped) 回调事件,当业务服务器收到 `web_recorder_stopped` 回调,且 code 不为 `0`,表示页面录制异常停止,声网推荐你重新发起新的录制。