tencentcloud-sdk-nodejs-live 4.0.262 → 4.0.266

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/CHANGELOG.md +471 -0
  2. package/SERVICE_CHANGELOG.md +595 -12
  3. package/package.json +1 -1
  4. package/products.md +24 -24
  5. package/src/services/live/v20180801/live_client.ts +7 -6
  6. package/src/services/live/v20180801/live_models.ts +28 -0
  7. package/tencentcloud/services/live/v20180801/live_client.d.ts +7 -6
  8. package/tencentcloud/services/live/v20180801/live_client.js +7 -6
  9. package/tencentcloud/services/live/v20180801/live_models.d.ts +26 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-live",
3
- "version": "4.0.262",
3
+ "version": "4.0.266",
4
4
  "description": "Tencent Cloud API NODEJS SDK",
5
5
  "main": "tencentcloud/index.js",
6
6
  "scripts": {
package/products.md CHANGED
@@ -12,13 +12,13 @@
12
12
  | ape | [正版图库直通车](https://cloud.tencent.com/document/product/1181) | 2021-11-10 08:02:03 |
13
13
  | api | [云 API](https://cloud.tencent.com/document/product/546) | 2021-04-25 10:09:57 |
14
14
  | apigateway | [API网关](https://cloud.tencent.com/document/product/628) | 2021-12-08 08:05:34 |
15
- | apm | [应用性能观测](https://cloud.tencent.com/document/product/1463) | 2021-12-02 08:02:32 |
16
- | as | [弹性伸缩](https://cloud.tencent.com/document/product/377) | 2021-12-27 08:00:45 |
15
+ | apm | [应用性能观测](https://cloud.tencent.com/document/product/1463) | 2022-01-05 08:03:38 |
16
+ | as | [弹性伸缩](https://cloud.tencent.com/document/product/377) | 2022-01-05 08:03:39 |
17
17
  | asr | [语音识别](https://cloud.tencent.com/document/product/1093) | 2021-12-22 08:06:39 |
18
18
  | asw | [应用与服务编排工作流](https://cloud.tencent.com/document/product/1272) | 2021-11-29 08:03:58 |
19
19
  | ba | [网站备案](https://cloud.tencent.com/document/product/243) | 2021-11-10 08:02:33 |
20
20
  | batch | [批量计算](https://cloud.tencent.com/document/product/599) | 2021-11-10 08:02:34 |
21
- | bda | [人体分析](https://cloud.tencent.com/document/product/1208) | 2021-12-07 08:02:49 |
21
+ | bda | [人体分析](https://cloud.tencent.com/document/product/1208) | 2022-01-03 08:04:43 |
22
22
  | billing | [计费相关](https://cloud.tencent.com/document/product/555) | 2021-12-16 08:04:53 |
23
23
  | bizlive | [商业直播](https://cloud.tencent.com/document/product) | 2020-03-10 01:08:07 |
24
24
  | bm | [黑石物理服务器1.0](https://cloud.tencent.com/document/product/386) | 2021-11-10 08:02:45 |
@@ -32,8 +32,8 @@
32
32
  | cat | [云拨测](https://cloud.tencent.com/document/product/280) | 2021-12-22 08:07:25 |
33
33
  | cbs | [云硬盘](https://cloud.tencent.com/document/product/362) | 2021-12-21 08:01:42 |
34
34
  | ccc | [云呼叫中心](https://cloud.tencent.com/document/product/679) | 2021-12-10 08:02:29 |
35
- | cdb | [云数据库 MySQL](https://cloud.tencent.com/document/product/236) | 2021-12-24 08:06:02 |
36
- | cdn | [内容分发网络](https://cloud.tencent.com/document/product/228) | 2021-12-17 08:07:56 |
35
+ | cdb | [云数据库 MySQL](https://cloud.tencent.com/document/product/236) | 2022-01-05 08:04:53 |
36
+ | cdn | [内容分发网络](https://cloud.tencent.com/document/product/228) | 2022-01-05 08:05:09 |
37
37
  | cds | [数据安全审计](https://cloud.tencent.com/document/product/856) | 2021-12-24 08:06:33 |
38
38
  | cfs | [文件存储](https://cloud.tencent.com/document/product/582) | 2021-12-06 08:02:54 |
39
39
  | cfw | [云防火墙](https://cloud.tencent.com/document/product/1132) | 2021-12-01 08:04:35 |
@@ -45,7 +45,7 @@
45
45
  | clb | [负载均衡](https://cloud.tencent.com/document/product/214) | 2021-12-24 08:06:58 |
46
46
  | cloudaudit | [云审计](https://cloud.tencent.com/document/product/629) | 2021-11-16 08:07:51 |
47
47
  | cloudhsm | [云加密机](https://cloud.tencent.com/document/product/639) | 2021-11-10 08:04:28 |
48
- | cls | [日志服务](https://cloud.tencent.com/document/product/614) | 2021-12-17 08:08:49 |
48
+ | cls | [日志服务](https://cloud.tencent.com/document/product/614) | 2022-01-05 08:06:03 |
49
49
  | cme | [多媒体创作引擎](https://cloud.tencent.com/document/product/1156) | 2021-12-24 08:07:24 |
50
50
  | cmq | [消息队列 CMQ](https://cloud.tencent.com/document/product/406) | 2021-11-10 08:04:45 |
51
51
  | cms | [内容安全](https://cloud.tencent.com/document/product) | 2020-10-29 08:03:08 |
@@ -69,16 +69,16 @@
69
69
  | ecc | [英文作文批改](https://cloud.tencent.com/document/product/1076) | 2021-11-10 08:06:30 |
70
70
  | ecdn | [全站加速网络](https://cloud.tencent.com/document/product/570) | 2021-12-22 08:11:17 |
71
71
  | ecm | [边缘计算机器](https://cloud.tencent.com/document/product/1108) | 2021-12-06 08:05:41 |
72
- | eiam | [数字身份管控平台（员工版）](https://cloud.tencent.com/document/product/1442) | 2021-12-15 08:07:41 |
72
+ | eiam | [数字身份管控平台（员工版）](https://cloud.tencent.com/document/product/1442) | 2022-01-05 08:08:30 |
73
73
  | eis | [企业集成服务](https://cloud.tencent.com/document/product/1270) | 2021-11-10 08:06:56 |
74
74
  | emr | [弹性 MapReduce](https://cloud.tencent.com/document/product/589) | 2021-12-10 08:06:20 |
75
- | es | [Elasticsearch Service](https://cloud.tencent.com/document/product/845) | 2021-12-22 16:41:08 |
75
+ | es | [Elasticsearch Service](https://cloud.tencent.com/document/product/845) | 2021-12-30 08:09:09 |
76
76
  | essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2021-12-23 08:10:29 |
77
- | facefusion | [人脸融合](https://cloud.tencent.com/document/product/670) | 2021-11-18 08:08:10 |
77
+ | facefusion | [人脸融合](https://cloud.tencent.com/document/product/670) | 2022-01-05 08:08:53 |
78
78
  | faceid | [人脸核身](https://cloud.tencent.com/document/product/1007) | 2021-12-21 08:05:56 |
79
79
  | fmu | [人脸试妆](https://cloud.tencent.com/document/product/1172) | 2021-12-14 08:10:17 |
80
80
  | ft | [人像变换](https://cloud.tencent.com/document/product/1202) | 2021-12-08 08:10:45 |
81
- | gaap | [全球应用加速](https://cloud.tencent.com/document/product/608) | 2021-12-03 08:06:49 |
81
+ | gaap | [全球应用加速](https://cloud.tencent.com/document/product/608) | 2021-12-30 08:09:28 |
82
82
  | gme | [游戏多媒体引擎](https://cloud.tencent.com/document/product/607) | 2021-12-23 08:10:54 |
83
83
  | gpm | [游戏玩家匹配](https://cloud.tencent.com/document/product/1294) | 2021-11-10 08:07:27 |
84
84
  | gs | [云游戏解决方案](https://cloud.tencent.com/document/product/1162) | 2021-12-07 08:07:40 |
@@ -100,15 +100,15 @@
100
100
  | ivld | [视频智能标签](https://cloud.tencent.com/document/product/1509) | 2021-11-30 14:56:41 |
101
101
  | kms | [密钥管理系统](https://cloud.tencent.com/document/product/573) | 2021-12-24 08:11:42 |
102
102
  | lighthouse | [轻量应用服务器](https://cloud.tencent.com/document/product/1207) | 2021-12-21 08:07:35 |
103
- | live | [云直播](https://cloud.tencent.com/document/product/267) | 2021-12-15 08:10:09 |
103
+ | live | [云直播](https://cloud.tencent.com/document/product/267) | 2022-01-05 08:10:51 |
104
104
  | lp | [登录保护](https://cloud.tencent.com/document/product/1190) | 2021-11-10 08:08:46 |
105
105
  | mariadb | [云数据库 MariaDB](https://cloud.tencent.com/document/product/237) | 2021-12-17 08:13:52 |
106
106
  | market | [云市场](https://cloud.tencent.com/document/product/306) | 2021-11-10 08:08:54 |
107
107
  | memcached | [云数据库 Memcached](https://cloud.tencent.com/document/product) | 2020-08-24 08:07:49 |
108
108
  | mgobe | [游戏联机对战引擎](https://cloud.tencent.com/document/product/1038) | 2021-11-10 08:08:55 |
109
109
  | mna | [移动网络加速](https://cloud.tencent.com/document/product/1385) | 2021-11-10 08:08:55 |
110
- | mongodb | [云数据库 MongoDB](https://cloud.tencent.com/document/product/240) | 2021-12-14 08:12:21 |
111
- | monitor | [云监控](https://cloud.tencent.com/document/product/248) | 2021-12-16 08:11:56 |
110
+ | mongodb | [云数据库 MongoDB](https://cloud.tencent.com/document/product/240) | 2022-01-05 08:11:21 |
111
+ | monitor | [云监控](https://cloud.tencent.com/document/product/248) | 2021-12-30 08:11:53 |
112
112
  | mps | [视频处理](https://cloud.tencent.com/document/product/862) | 2021-11-24 08:11:23 |
113
113
  | mrs | [医疗报告结构化](https://cloud.tencent.com/document/product/1314) | 2021-12-14 08:12:50 |
114
114
  | ms | [移动应用安全](https://cloud.tencent.com/document/product) | 2020-06-05 08:13:52 |
@@ -118,20 +118,20 @@
118
118
  | npp | [号码保护](https://cloud.tencent.com/document/product) | 2020-04-22 08:00:22 |
119
119
  | oceanus | [流计算 Oceanus](https://cloud.tencent.com/document/product/849) | 2021-12-21 08:08:44 |
120
120
  | ocr | [文字识别](https://cloud.tencent.com/document/product/866) | 2021-12-27 08:08:41 |
121
- | organization | [企业组织](https://cloud.tencent.com/document/product/850) | 2021-11-10 08:09:46 |
121
+ | organization | [企业组织](https://cloud.tencent.com/document/product/850) | 2021-12-30 08:12:38 |
122
122
  | partners | [渠道合作伙伴](https://cloud.tencent.com/document/product/563) | 2021-11-18 08:11:02 |
123
123
  | pds | [私域安全](https://cloud.tencent.com/document/product/1473) | 2021-11-10 08:09:50 |
124
124
  | postgres | [云数据库 PostgreSQL](https://cloud.tencent.com/document/product/409) | 2021-12-24 08:13:26 |
125
125
  | privatedns | [私有域解析 Private DNS](https://cloud.tencent.com/document/product/1338) | 2021-12-23 08:13:49 |
126
- | rce | [全栈式风控引擎](https://cloud.tencent.com/document/product/1343) | 2021-11-10 08:10:02 |
126
+ | rce | [全栈式风控引擎](https://cloud.tencent.com/document/product/1343) | 2021-12-29 08:11:26 |
127
127
  | redis | [云数据库 Redis](https://cloud.tencent.com/document/product/239) | 2021-12-07 13:09:58 |
128
128
  | rkp | [风险探针](https://cloud.tencent.com/document/product/1169) | 2021-11-10 08:10:03 |
129
129
  | rp | [注册保护](https://cloud.tencent.com/document/product/1191) | 2021-11-10 08:10:04 |
130
130
  | rum | [前端性能监控](https://cloud.tencent.com/document/product/1464) | 2021-12-16 08:13:07 |
131
131
  | scf | [云函数](https://cloud.tencent.com/document/product/583) | 2021-12-23 08:14:05 |
132
- | ses | [邮件推送](https://cloud.tencent.com/document/product/1288) | 2021-11-26 08:12:29 |
132
+ | ses | [邮件推送](https://cloud.tencent.com/document/product/1288) | 2022-01-05 08:12:45 |
133
133
  | smpn | [营销号码安全](https://cloud.tencent.com/document/product/1127) | 2021-11-10 08:10:15 |
134
- | sms | [短信](https://cloud.tencent.com/document/product/382) | 2021-12-16 08:13:20 |
134
+ | sms | [短信](https://cloud.tencent.com/document/product/382) | 2022-01-05 08:12:50 |
135
135
  | soe | [智聆口语评测](https://cloud.tencent.com/document/product/884) | 2021-11-18 08:11:34 |
136
136
  | solar | [智汇零售](https://cloud.tencent.com/document/product) | 2020-03-19 08:01:59 |
137
137
  | sqlserver | [云数据库 SQL Server](https://cloud.tencent.com/document/product/238) | 2021-12-17 08:15:35 |
@@ -148,31 +148,31 @@
148
148
  | tbm | [](https://cloud.tencent.com/document/product) | 2019-03-29 14:49:11 |
149
149
  | tbp | [腾讯智能对话平台](https://cloud.tencent.com/document/product/1060) | 2021-11-10 08:10:55 |
150
150
  | tcaplusdb | [游戏数据库 TcaplusDB](https://cloud.tencent.com/document/product/596) | 2021-11-10 08:10:55 |
151
- | tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2021-12-14 08:14:39 |
151
+ | tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2021-12-31 08:15:28 |
152
152
  | tcex | [腾讯云释义](https://cloud.tencent.com/document/product/1266) | 2021-11-10 08:11:12 |
153
153
  | tci | [腾讯智学课堂分析](https://cloud.tencent.com/document/product) | 2020-08-24 08:06:03 |
154
154
  | tcm | [服务网格](https://cloud.tencent.com/document/product/1261) | 2021-11-18 08:12:32 |
155
155
  | tcr | [容器镜像服务](https://cloud.tencent.com/document/product/1141) | 2021-12-24 08:15:03 |
156
156
  | tcss | [容器安全服务](https://cloud.tencent.com/document/product/1285) | 2021-12-22 08:16:46 |
157
157
  | tdid | [分布式身份](https://cloud.tencent.com/document/product/1439) | 2021-11-10 08:11:24 |
158
- | tdmq | [分布式消息队列](https://cloud.tencent.com/document/product/1179) | 2021-12-21 08:11:07 |
159
- | tem | [弹性微服务](https://cloud.tencent.com/document/product/1371) | 2021-12-23 08:16:03 |
158
+ | tdmq | [分布式消息队列](https://cloud.tencent.com/document/product/1179) | 2021-12-29 08:13:22 |
159
+ | tem | [弹性微服务](https://cloud.tencent.com/document/product/1371) | 2021-12-30 08:15:01 |
160
160
  | thpc | [高性能计算平台](https://cloud.tencent.com/document/product/1527) | 2021-12-27 08:11:18 |
161
161
  | tia | [智能钛机器学习](https://cloud.tencent.com/document/product/851) | 2021-10-21 11:12:52 |
162
162
  | tic | [腾讯云IaC平台](https://cloud.tencent.com/document/product/1213) | 2021-11-10 08:11:35 |
163
163
  | ticm | [智能鉴黄](https://cloud.tencent.com/document/product/864) | 2021-01-07 08:08:15 |
164
164
  | tics | [威胁情报云查服务](https://cloud.tencent.com/document/product/1013) | 2021-11-10 08:11:37 |
165
- | tiems | [智能钛弹性模型服务](https://cloud.tencent.com/document/product/1120) | 2021-11-10 08:11:38 |
165
+ | tiems | [腾讯云 TI 平台 TI-EMS ](https://cloud.tencent.com/document/product/1120) | 2021-12-31 11:26:13 |
166
166
  | tiia | [图像分析](https://cloud.tencent.com/document/product/865) | 2021-12-22 08:17:35 |
167
- | tione | [智能钛机器学习平台](https://cloud.tencent.com/document/product/851) | 2021-11-10 08:11:45 |
167
+ | tione | [腾讯云 TI 平台 TI-ONE](https://cloud.tencent.com/document/product/851) | 2021-12-31 11:26:17 |
168
168
  | tiw | [互动白板](https://cloud.tencent.com/document/product/1137) | 2021-12-27 08:11:32 |
169
- | tke | [容器服务](https://cloud.tencent.com/document/product/457) | 2021-12-24 08:16:08 |
169
+ | tke | [容器服务](https://cloud.tencent.com/document/product/457) | 2022-01-05 08:14:55 |
170
170
  | tkgdq | [腾讯知识图谱数据查询](https://cloud.tencent.com/document/product) | 2020-03-10 00:51:44 |
171
171
  | tms | [文本内容安全](https://cloud.tencent.com/document/product/1124) | 2021-12-24 08:16:25 |
172
172
  | tmt | [机器翻译](https://cloud.tencent.com/document/product/551) | 2021-11-10 08:12:05 |
173
173
  | trtc | [实时音视频](https://cloud.tencent.com/document/product/647) | 2021-11-11 11:09:51 |
174
174
  | tse | [腾讯云微服务引擎](https://cloud.tencent.com/document/product/1364) | 2021-12-16 08:15:47 |
175
- | tsf | [腾讯微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2021-12-24 08:16:33 |
175
+ | tsf | [腾讯微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2022-01-05 08:15:18 |
176
176
  | tsw | [腾讯微服务观测平台 TSW](https://cloud.tencent.com/document/product/1311) | 2021-11-10 08:12:32 |
177
177
  | tts | [语音合成](https://cloud.tencent.com/document/product/1073) | 2021-12-21 08:12:28 |
178
178
  | ump | [客流数字化平台](https://cloud.tencent.com/document/product/1320) | 2021-11-10 08:12:34 |
package/src/services/live/v20180801/live_client.ts CHANGED
@@ -1434,14 +1434,15 @@ DomainName+AppName+StreamName+TemplateId唯一标识单个转码规则，如需
1434
1434
 
1435
1435
  /**
1436
1436
  * 返回直播中、无推流或者禁播等状态。
1437
- 注意：该接口仅提供辅助查询流状态功能，业务重要场景不要强依赖该接口！
1438
1437
 
1439
1438
  使用建议：
1440
- 1. 去除将该接口的返回结果作为开播、关播等重要业务场景的依赖。
1441
- 2. 如业务需要该状态,可通过[推断流事件通知](/document/product/267/47025)进行存储维护直播间状态。
1442
- 3. 自行维护的直播间状态,可通过定时(>1 min)[查询直播中的流接口](/document/product/267/20472),进行状态校准。
1443
- 4. 如使用了流状态查询接口查询到流不活跃,可通过上述多种方案综合判定流状态。
1444
- 5. 接口查询时,如发生访问异常或解析异常等,可默认为活跃,减少对业务影响。
1439
+ 该接口提供实时流状态查询功能，鉴于网络抖动等一些不可抗因素，使用该接口作为判断主播是否开播等重要业务场景时，请参考以下使用建议。
1440
+ 1. 优先使用业务自身的房间开关播逻辑，判断主播是否在线，譬如客户端开播信令和主播在线心跳等。
1441
+ 2. 对于没有房间管理的直播场景，可以结合以下方案综合判断。
1442
+ 2.1 根据[推断流事件通知](/document/product/267/20388) 判断主播在线状态。
1443
+ 2.2 通过定时（间隔>1min）查询[直播中的流接口](/document/api/267/20472)，判断主播是否在线。
1444
+ 2.3 通过 本接口 查询直播流状态，判断主播是否在线。
1445
+ 2.4 以上任一方式判断为在线，都认为主播开播中，并且接口查询超时或解析异常时，也默认为在线，减少对业务的影响。
1445
1446
  */
1446
1447
  async DescribeLiveStreamState(
1447
1448
  req: DescribeLiveStreamStateRequest,
package/src/services/live/v20180801/live_models.ts CHANGED
@@ -1599,6 +1599,20 @@ Oversea：则查询国际/港澳台（境外）数据，
1599
1599
  默认值：5。
1600
1600
  */
1601
1601
  Granularity?: number
1602
+
1603
+ /**
1604
+ * 大区，映射表如下：
1605
+ China Mainland 中国大陆
1606
+ Asia Pacific I 亚太一区
1607
+ Asia Pacific II 亚太二区
1608
+ Asia Pacific III 亚太三区
1609
+ Europe 欧洲
1610
+ North America 北美
1611
+ South America 南美
1612
+ Middle East 中东
1613
+ Africa 非洲。
1614
+ */
1615
+ RegionNames?: Array<string>
1602
1616
  }
1603
1617
 
1604
1618
  /**
@@ -6710,6 +6724,20 @@ Oversea：则查询国外数据，
6710
6724
  * 服务名称，可选值包括LVB(标准直播)，LEB(快直播)，不填则查LVB+LEB总值。
6711
6725
  */
6712
6726
  ServiceName?: string
6727
+
6728
+ /**
6729
+ * 大区，映射表如下：
6730
+ China Mainland 中国大陆
6731
+ Asia Pacific I 亚太一区
6732
+ Asia Pacific II 亚太二区
6733
+ Asia Pacific III 亚太三区
6734
+ Europe 欧洲
6735
+ North America 北美
6736
+ South America 南美
6737
+ Middle East 中东
6738
+ Africa 非洲。
6739
+ */
6740
+ RegionNames?: Array<string>
6713
6741
  }
6714
6742
 
6715
6743
  /**
package/tencentcloud/services/live/v20180801/live_client.d.ts CHANGED
@@ -494,14 +494,15 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
494
494
  DescribeLivePlayAuthKey(req: DescribeLivePlayAuthKeyRequest, cb?: (error: string, rep: DescribeLivePlayAuthKeyResponse) => void): Promise<DescribeLivePlayAuthKeyResponse>;
495
495
  /**
496
496
  * 返回直播中、无推流或者禁播等状态。
497
- 注意：该接口仅提供辅助查询流状态功能，业务重要场景不要强依赖该接口！
498
497
 
499
498
  使用建议：
500
- 1. 去除将该接口的返回结果作为开播、关播等重要业务场景的依赖。
501
- 2. 如业务需要该状态,可通过[推断流事件通知](/document/product/267/47025)进行存储维护直播间状态。
502
- 3. 自行维护的直播间状态,可通过定时(>1 min)[查询直播中的流接口](/document/product/267/20472),进行状态校准。
503
- 4. 如使用了流状态查询接口查询到流不活跃,可通过上述多种方案综合判定流状态。
504
- 5. 接口查询时,如发生访问异常或解析异常等,可默认为活跃,减少对业务影响。
499
+ 该接口提供实时流状态查询功能，鉴于网络抖动等一些不可抗因素，使用该接口作为判断主播是否开播等重要业务场景时，请参考以下使用建议。
500
+ 1. 优先使用业务自身的房间开关播逻辑，判断主播是否在线，譬如客户端开播信令和主播在线心跳等。
501
+ 2. 对于没有房间管理的直播场景，可以结合以下方案综合判断。
502
+ 2.1 根据[推断流事件通知](/document/product/267/20388) 判断主播在线状态。
503
+ 2.2 通过定时（间隔>1min）查询[直播中的流接口](/document/api/267/20472)，判断主播是否在线。
504
+ 2.3 通过 本接口 查询直播流状态，判断主播是否在线。
505
+ 2.4 以上任一方式判断为在线，都认为主播开播中，并且接口查询超时或解析异常时，也默认为在线，减少对业务的影响。
505
506
  */
506
507
  DescribeLiveStreamState(req: DescribeLiveStreamStateRequest, cb?: (error: string, rep: DescribeLiveStreamStateResponse) => void): Promise<DescribeLiveStreamStateResponse>;
507
508
  /**
package/tencentcloud/services/live/v20180801/live_client.js CHANGED
@@ -723,14 +723,15 @@ class Client extends TencentCloudCommon.AbstractClient {
723
723
  }
724
724
  /**
725
725
  * 返回直播中、无推流或者禁播等状态。
726
- 注意：该接口仅提供辅助查询流状态功能，业务重要场景不要强依赖该接口！
727
726
 
728
727
  使用建议：
729
- 1. 去除将该接口的返回结果作为开播、关播等重要业务场景的依赖。
730
- 2. 如业务需要该状态,可通过[推断流事件通知](/document/product/267/47025)进行存储维护直播间状态。
731
- 3. 自行维护的直播间状态,可通过定时(>1 min)[查询直播中的流接口](/document/product/267/20472),进行状态校准。
732
- 4. 如使用了流状态查询接口查询到流不活跃,可通过上述多种方案综合判定流状态。
733
- 5. 接口查询时,如发生访问异常或解析异常等,可默认为活跃,减少对业务影响。
728
+ 该接口提供实时流状态查询功能，鉴于网络抖动等一些不可抗因素，使用该接口作为判断主播是否开播等重要业务场景时，请参考以下使用建议。
729
+ 1. 优先使用业务自身的房间开关播逻辑，判断主播是否在线，譬如客户端开播信令和主播在线心跳等。
730
+ 2. 对于没有房间管理的直播场景，可以结合以下方案综合判断。
731
+ 2.1 根据[推断流事件通知](/document/product/267/20388) 判断主播在线状态。
732
+ 2.2 通过定时（间隔>1min）查询[直播中的流接口](/document/api/267/20472)，判断主播是否在线。
733
+ 2.3 通过 本接口 查询直播流状态，判断主播是否在线。
734
+ 2.4 以上任一方式判断为在线，都认为主播开播中，并且接口查询超时或解析异常时，也默认为在线，减少对业务的影响。
734
735
  */
735
736
  async DescribeLiveStreamState(req, cb) {
736
737
  return this.request("DescribeLiveStreamState", req, cb);
package/tencentcloud/services/live/v20180801/live_models.d.ts CHANGED
@@ -1348,6 +1348,19 @@ export interface DescribePushBandwidthAndFluxListRequest {
1348
1348
  默认值：5。
1349
1349
  */
1350
1350
  Granularity?: number;
1351
+ /**
1352
+ * 大区，映射表如下：
1353
+ China Mainland 中国大陆
1354
+ Asia Pacific I 亚太一区
1355
+ Asia Pacific II 亚太二区
1356
+ Asia Pacific III 亚太三区
1357
+ Europe 欧洲
1358
+ North America 北美
1359
+ South America 南美
1360
+ Middle East 中东
1361
+ Africa 非洲。
1362
+ */
1363
+ RegionNames?: Array<string>;
1351
1364
  }
1352
1365
  /**
1353
1366
  * CreateLiveRecordRule请求参数结构体
@@ -5714,6 +5727,19 @@ export interface DescribeBillBandwidthAndFluxListRequest {
5714
5727
  * 服务名称，可选值包括LVB(标准直播)，LEB(快直播)，不填则查LVB+LEB总值。
5715
5728
  */
5716
5729
  ServiceName?: string;
5730
+ /**
5731
+ * 大区，映射表如下：
5732
+ China Mainland 中国大陆
5733
+ Asia Pacific I 亚太一区
5734
+ Asia Pacific II 亚太二区
5735
+ Asia Pacific III 亚太三区
5736
+ Europe 欧洲
5737
+ North America 北美
5738
+ South America 南美
5739
+ Middle East 中东
5740
+ Africa 非洲。
5741
+ */
5742
+ RegionNames?: Array<string>;
5717
5743
  }
5718
5744
  /**
5719
5745
  * DescribeLiveRecordRules返回参数结构体