@tencentcloud/sdk-mcp 1.1.6 → 1.1.8

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 (33) hide show
  1. package/package.json +1 -1
  2. package/resource/doc/chatuikit/react/chat_window_integration.md +20 -16
  3. package/resource/doc/chatuikit/react/integration.md +22 -13
  4. package/resource/doc/chatuikit/vue/integration.md +3 -3
  5. package/resource/doc/tuicallkit/react/{api_TUICallKit.md → api.md} +52 -465
  6. package/resource/doc/tuicallkit/react/integration.md +86 -0
  7. package/resource/doc/tuicallkit/vue/{api_TUICallKit.md → api.md} +52 -468
  8. package/resource/doc/tuicallkit/vue/integration.md +83 -0
  9. package/tools/call/get-web-call-api.js +30 -0
  10. package/tools/call/get-web-call-api.js.map +1 -0
  11. package/tools/call/get-web-call-integration.js +8 -10
  12. package/tools/call/get-web-call-integration.js.map +1 -1
  13. package/tools/chat/get-web-chat-component-detail.js +2 -1
  14. package/tools/chat/get-web-chat-component-detail.js.map +1 -1
  15. package/tools/common/get-official-experience-account.js +52 -0
  16. package/tools/common/get-official-experience-account.js.map +1 -0
  17. package/tools/common/get-usersig.js +2 -2
  18. package/tools/index.js +4 -0
  19. package/tools/index.js.map +1 -1
  20. package/resource/doc/tuicallkit/react/.gitkeep +0 -0
  21. package/resource/doc/tuicallkit/react/how_to_integrated_react_callkit.md +0 -195
  22. package/resource/doc/tuicallkit/react/how_to_run_react_callkit_demo.md +0 -93
  23. package/resource/doc/tuicallkit/vue/.gitkeep +0 -0
  24. package/resource/doc/tuicallkit/vue/how_to_integrated_vue_callkit.md +0 -418
  25. package/resource/doc/tuicallkit/vue/how_to_run_vue_callkit_demo.md +0 -96
  26. /package/resource/doc/chatuikit/{ios → iOS}/client_api_iOS.md +0 -0
  27. /package/resource/doc/chatuikit/{ios → iOS}/integrate_tuichat_only_iOS.md +0 -0
  28. /package/resource/doc/chatuikit/{ios → iOS}/integrate_tuikit_iOS.md +0 -0
  29. /package/resource/doc/chatuikit/{ios → iOS}/ui_api_iOS.md +0 -0
  30. /package/resource/doc/tuicallkit/{ios → iOS}/api_TUICallKit.md +0 -0
  31. /package/resource/doc/tuicallkit/{ios → iOS}/api_TUICallObserver.md +0 -0
  32. /package/resource/doc/tuicallkit/{ios → iOS}/how_to_integrated_iOS_callkit.md +0 -0
  33. /package/resource/doc/tuicallkit/{ios → iOS}/how_to_run_iOS_callkit_demo.md +0 -0
@@ -1,12 +1,8 @@
1
- AI 模型必须遵守以下**硬性限制**。
2
- 1. **音视频通话组件必须使用 calls API:** 集成 TUICallKit 时必须使用 `TUICallKitServer.calls` API 发起通话, `call` 和 `groupCall` 接口已废弃,不推荐使用。
3
-
4
1
  TUICallKit 是音视频通话组件的**含 UI 接口**,使用 TUICallKit API,您可以通过简单接口快速实现一个类微信的音视频通话场景;更详细的接入步骤,详见:[快速接入 TUICallKit](https://write.woa.com/document/130513425899630592)。
5
2
 
6
3
  > **说明:**
7
4
  >
8
- > - 为提供更优质的音视频通信能力, TUICallKit npm 包 [@tencentcloud/call-uikit-react](https://www.npmjs.com/package/@tencentcloud/call-uikit-react)、[@tencentcloud/call-uikit-vue](https://www.npmjs.com/package/@tencentcloud/call-uikit-vue)、[@tencentcloud/call-uikit-vue2](https://www.npmjs.com/package/@tencentcloud/call-uikit-vue2)、[@tencentcloud/call-uikit-vue2.6](https://www.npmjs.com/package/@tencentcloud/call-uikit-vue2.6) 在 4.0.0 版本进行了重大升级。
9
- > - v4.0.0+ 对接口进行了优化调整,废弃了部分接口,同步提供更简洁、稳定的新接口方案。
5
+ > - 为提供更优质的音视频通信能力, TUICallKit npm 包 [@trtc/calls-uikit-react](https://www.npmjs.com/package/@trtc/calls-uikit-react)、[@trtc/calls-uikit-vue](https://www.npmjs.com/package/@trtc/calls-uikit-vue)、[@trtc/calls-uikit-vue2](https://www.npmjs.com/package/@trtc/calls-uikit-vue2)、[@trtc/calls-uikit-vue2.6](https://www.npmjs.com/package/@trtc/calls-uikit-vue2.6) 在 4.0.0 版本进行了重大升级。
10
6
 
11
7
 
12
8
  ## API 概览
@@ -294,7 +290,7 @@ TUICallKit 是音视频通话组件的**含 UI 接口**,使用 TUICallKit API
294
290
 
295
291
  【React】
296
292
  ``` bash
297
- import { TUICallKit, VideoDisplayMode, VideoResolution } from "@tencentcloud/call-uikit-react";
293
+ import { TUICallKit, VideoDisplayMode, VideoResolution } from "@trtc/calls-uikit-react";
298
294
 
299
295
  <TUICallKit
300
296
  videoDisplayMode={VideoDisplayMode.CONTAIN}
@@ -329,7 +325,7 @@ function handleAfterCalling() {
329
325
  </template>
330
326
 
331
327
  <script lang="ts" setup>
332
- import { TUICallKit, TUICallKitServer, VideoDisplayMode, VideoResolution, STATUS } from "@tencentcloud/call-uikit-vue";
328
+ import { TUICallKit, TUICallKitAPI, VideoDisplayMode, VideoResolution, STATUS } from "@trtc/calls-uikit-vue";
333
329
 
334
330
  function beforeCalling(type: string, error: any) {
335
331
  console.log("[TUICallkit Demo] beforeCalling:", type, error);
@@ -371,7 +367,7 @@ function statusChanged(args: { oldStatus: string; newStatus: string; }) {
371
367
  </template>
372
368
 
373
369
  <script lang="ts" setup>
374
- import { TUICallKit, TUICallKitServer, VideoDisplayMode, VideoResolution, STATUS } from "@tencentcloud/call-uikit-vue2";
370
+ import { TUICallKit, TUICallKitAPI, VideoDisplayMode, VideoResolution, STATUS } from "@trtc/calls-uikit-vue2";
375
371
 
376
372
  function beforeCalling(type: string, error: any) {
377
373
  console.log("[TUICallkit Demo] beforeCalling:", type, error);
@@ -412,7 +408,7 @@ function statusChanged(args: { oldStatus: string; newStatus: string; }) {
412
408
  </template>
413
409
 
414
410
  <script lang="ts" setup>
415
- import { TUICallKit, TUICallKitServer, VideoDisplayMode, VideoResolution, STATUS } from "@tencentcloud/call-uikit-vue2.6";
411
+ import { TUICallKit, TUICallKitAPI, VideoDisplayMode, VideoResolution, STATUS } from "@trtc/calls-uikit-vue2.6";
416
412
 
417
413
  function beforeCalling(type: string, error: any) {
418
414
  console.log("[TUICallkit Demo] beforeCalling:", type, error);
@@ -435,32 +431,32 @@ function statusChanged(args: { oldStatus: string; newStatus: string; }) {
435
431
  </script>
436
432
  ```
437
433
 
438
- ## TUICallKitServer API 详情
434
+ ## TUICallKitAPI API 详情
439
435
 
440
436
 
441
437
 
442
438
 
443
439
  【React】
444
440
  ``` javascript
445
- import { TUICallKitServer } from "@tencentcloud/call-uikit-react";
441
+ import { TUICallKitAPI } from "@trtc/calls-uikit-react";
446
442
  ```
447
443
 
448
444
 
449
445
  【Vue3】
450
446
  ``` javascript
451
- import { TUICallKitServer } from "@tencentcloud/call-uikit-vue";
447
+ import { TUICallKitAPI } from "@trtc/calls-uikit-vue";
452
448
  ```
453
449
 
454
450
 
455
451
  【Vue2.7】
456
452
  ``` javascript
457
- import { TUICallKitServer } from "@tencentcloud/call-uikit-vue2";
453
+ import { TUICallKitAPI } from "@trtc/calls-uikit-vue2";
458
454
  ```
459
455
 
460
456
 
461
457
  【Vue2.6】
462
458
  ``` javascript
463
- import { TUICallKitServer } from "@tencentcloud/call-uikit-vue2.6";
459
+ import { TUICallKitAPI } from "@trtc/calls-uikit-vue2.6";
464
460
  ```
465
461
 
466
462
  ### init
@@ -468,9 +464,9 @@ import { TUICallKitServer } from "@tencentcloud/call-uikit-vue2.6";
468
464
  初始化 TUICallKit。
469
465
  ``` javascript
470
466
  try {
471
- await TUICallKitServer.init({ SDKAppID, userID, userSig });
467
+ await TUICallKitAPI.init({ SDKAppID, userID, userSig });
472
468
  // If you already have a tim instance in your project, you need to pass it in here.
473
- // await TUICallKitServer.init({ tim, SDKAppID, userID, userSig});
469
+ // await TUICallKitAPI.init({ tim, SDKAppID, userID, userSig});
474
470
  console.log("[TUICallKit] init succeeds.");
475
471
  } catch (error: any) {
476
472
  console.error(`[TUICallKit] init failed. Reason: ${error}`);
@@ -534,18 +530,11 @@ try {
534
530
  ### calls
535
531
 
536
532
  发起单人或多人通话。
537
-
538
- > **说明:**
539
- >
540
-
541
- > **v4.0.0+ 支持。**
542
- >
543
-
544
533
  ``` javascript
545
534
  try {
546
- await TUICallKitServer.calls({
535
+ await TUICallKitAPI.calls({
547
536
  userIDList: ['jack', 'tom'],
548
- type: TUICallType.VIDEO_CALL
537
+ type: CallMediaType.VIDEO_CALL
549
538
  });
550
539
  } catch (error: any) {
551
540
  console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
@@ -577,11 +566,11 @@ try {
577
566
  <tr>
578
567
  <td rowspan="1" colSpan="1" >type</td>
579
568
 
580
- <td rowspan="1" colSpan="1" >[TUICallType](https://cloud.tencent.com/document/product/647/81015#TUICallType)</td>
569
+ <td rowspan="1" colSpan="1" >[CallMediaType](https://cloud.tencent.com/document/product/647/81015#TUICallType)</td>
581
570
 
582
571
  <td rowspan="1" colSpan="1" >是</td>
583
572
 
584
- <td rowspan="1" colSpan="1" >通话的媒体类型,参数值说明参见 [TUICallType 通话类型](https://cloud.tencent.com/document/product/647/81015#TUICallType)<br>兼容旧版本:语音通话(type = 1)、视频通话(type = 2)</td>
573
+ <td rowspan="1" colSpan="1" >通话的媒体类型,参数值说明参见 [CallMediaType 通话类型](https://cloud.tencent.com/document/product/647/81015#TUICallType)<br>兼容旧版本:语音通话(type = 1)、视频通话(type = 2)</td>
585
574
  </tr>
586
575
 
587
576
  <tr>
@@ -649,16 +638,9 @@ try {
649
638
  ### join
650
639
 
651
640
  加入群组中已有的音视频通话。
652
-
653
- > **说明:**
654
- >
655
-
656
- > **v4.0.0+ 支持。**
657
- >
658
-
659
641
  ``` javascript
660
642
  try {
661
- await TUICallKitServer.join({callId: xx});
643
+ await TUICallKitAPI.join({callId: xx});
662
644
  } catch (error: any) {
663
645
  console.error(`[TUICallKit] Failed to call the join API. Reason: ${error}`);
664
646
  }
@@ -692,7 +674,7 @@ try {
692
674
 
693
675
  设置语言,目前支持:中文、英文、日文。
694
676
  ``` javascript
695
- TUICallKitServer.setLanguage("zh-cn"); // "en" | "zh-cn" | "ja_JP"
677
+ TUICallKitAPI.setLanguage("zh-cn"); // "en" | "zh-cn" | "ja_JP"
696
678
  ```
697
679
 
698
680
  参数如下表所示:
@@ -726,12 +708,12 @@ TUICallKitServer.setLanguage("zh-cn"); // "en" | "zh-cn" | "ja_JP"
726
708
  > **注意:**
727
709
  >
728
710
 
729
- > **v2.2.0+ 支持**。**通话中使用该接口修改用户信息,UI 不会立即更新,需要等到下次通话才能看到变化**。
711
+ > **通话中使用该接口修改用户信息,UI 不会立即更新,需要等到下次通话才能看到变化**。
730
712
  >
731
713
 
732
714
  ``` javascript
733
715
  try {
734
- await TUICallKitServer.setSelfInfo({ nickName: "xxx", avatar: "http://xxx" });
716
+ await TUICallKitAPI.setSelfInfo({ nickName: "xxx", avatar: "http://xxx" });
735
717
  } catch (error: any) {
736
718
  console.error(`[TUICallKit] Failed to call the setSelfInfo API. Reason: ${error}`;
737
719
  }
@@ -782,7 +764,7 @@ try {
782
764
 
783
765
  ``` javascript
784
766
  try {
785
- await TUICallKitServer.setCallingBell(filePath?: string)
767
+ await TUICallKitAPI.setCallingBell(filePath?: string)
786
768
  } catch (error: any) {
787
769
  console.error(`[TUICallKit] Failed to call the setCallingBell API. Reason: ${error}`);
788
770
  }
@@ -818,7 +800,7 @@ try {
818
800
  开启/关闭悬浮窗功能。默认为 false,通话界面左上角的悬浮窗按钮隐藏,设置为 true 后显示。
819
801
  ``` javascript
820
802
  try {
821
- await TUICallKitServer.enableFloatWindow(enable: Boolean)
803
+ await TUICallKitAPI.enableFloatWindow(enable: Boolean)
822
804
  } catch (error: any) {
823
805
  console.error(`[TUICallKit] Failed to call the enableFloatWindow API. Reason: ${error}`);
824
806
  }
@@ -829,7 +811,7 @@ try {
829
811
  开启/关闭来电铃声。开启后,收到通话请求时,不会播放来电铃声。
830
812
  ``` javascript
831
813
  try {
832
- await TUICallKitServer.enableMuteMode(enable: boolean)
814
+ await TUICallKitAPI.enableMuteMode(enable: boolean)
833
815
  } catch (error: any) {
834
816
  console.error(`[TUICallKit] Failed to call the enableMuteMode API. Reason: ${error}`);
835
817
  }
@@ -862,17 +844,10 @@ try {
862
844
  ### enableVirtualBackground
863
845
 
864
846
  开启/关闭模糊背景功能。如果想设置图片背景模糊参见 [Web](https://cloud.tencent.com/document/product/647/106071)。通过调用接口,您可以在 UI 上显示模糊背景的功能按钮,点击按钮可直接启用模糊背景功能。
865
-
866
- > **注意:**
867
- >
868
-
869
- > **v3.2.4+ 支持。**
870
- >
871
-
872
847
  ``` javascript
873
- import { TUICallKitServer } from "@tencentcloud/call-uikit-react";
848
+ import { TUICallKitAPI } from "@trtc/calls-uikit-react";
874
849
  const enable = true;
875
- TUICallKitServer.enableVirtualBackground(enable);
850
+ TUICallKitAPI.enableVirtualBackground(enable);
876
851
  ```
877
852
 
878
853
  参数列表:
@@ -906,7 +881,7 @@ TUICallKitServer.enableVirtualBackground(enable);
906
881
  该方法不会自动退出`tim`,需要手动退出`tim.logout();`。
907
882
  ``` javascript
908
883
  try {
909
- await TUICallKitServer.destroyed();
884
+ await TUICallKitAPI.destroyed();
910
885
  } catch (error: any) {
911
886
  alert(`[TUICallKit] Failed to call the destroyed API. Reason: ${error}`);
912
887
  }
@@ -916,29 +891,22 @@ try {
916
891
 
917
892
  隐藏功能按钮,目前仅支持 摄像头,麦克风和切换前后置按钮。
918
893
 
919
- > **注意:**
920
- >
921
-
922
- > **v3.2.9+ 支持。**
923
- >
924
-
925
-
926
894
 
927
895
 
928
896
 
929
897
  【Vue】
930
898
  ``` javascript
931
- import { TUICallKitServer, FeatureButton } from "@tencentcloud/call-uikit-vue";
899
+ import { TUICallKitAPI, FeatureButton } from "@trtc/calls-uikit-vue";
932
900
 
933
- TUICallKitServer.hideFeatureButton(FeatureButton.Camera);
901
+ TUICallKitAPI.hideFeatureButton(FeatureButton.Camera);
934
902
  ```
935
903
 
936
904
 
937
905
  【React】
938
906
  ``` javascript
939
- import { TUICallKitServer, FeatureButton } from "@tencentcloud/call-uikit-react";
907
+ import { TUICallKitAPI, FeatureButton } from "@trtc/calls-uikit-react";
940
908
 
941
- TUICallKitServer.hideFeatureButton(FeatureButton.Camera);
909
+ TUICallKitAPI.hideFeatureButton(FeatureButton.Camera);
942
910
  ```
943
911
 
944
912
  参数列表:
@@ -968,15 +936,8 @@ TUICallKitServer.hideFeatureButton(FeatureButton.Camera);
968
936
  ### setLocalViewBackgroundImage
969
937
 
970
938
  设置本地用户通话背景。
971
-
972
- > **注意:**
973
- >
974
-
975
- > **v3.2.9+ 支持。**
976
- >
977
-
978
939
  ``` typescript
979
- TUICallKitServer.setLocalViewBackgroundImage('http://xxx.png');
940
+ TUICallKitAPI.setLocalViewBackgroundImage('http://xxx.png');
980
941
  ```
981
942
 
982
943
  参数列表:
@@ -1006,17 +967,10 @@ TUICallKitServer.setLocalViewBackgroundImage('http://xxx.png');
1006
967
  ### setRemoteViewBackgroundImage
1007
968
 
1008
969
  设置远端用户通话背景。
1009
-
1010
- > **注意:**
1011
- >
1012
-
1013
- > **v3.2.9+ 支持。**
1014
- >
1015
-
1016
970
  ``` javascript
1017
971
  const userId = 'xxx';
1018
972
  const url = 'http://xxx.png';
1019
- TUICallKitServer.setRemoteViewBackgroundImage(userId, url);
973
+ TUICallKitAPI.setRemoteViewBackgroundImage(userId, url);
1020
974
  ```
1021
975
 
1022
976
  参数列表:
@@ -1057,27 +1011,20 @@ TUICallKitServer.setRemoteViewBackgroundImage(userId, url);
1057
1011
 
1058
1012
  设置通话界面布局模式。
1059
1013
 
1060
- > **注意:**
1061
- >
1062
-
1063
- > **v3.3.0+ 支持。**
1064
- >
1065
-
1066
-
1067
1014
 
1068
1015
 
1069
1016
 
1070
1017
  【Vue】
1071
1018
  ``` javascript
1072
- import { TUICallKitServer, LayoutMode } from "@tencentcloud/call-uikit-vue";
1073
- TUICallKitServer.setLayoutMode(LayoutMode.LocalInLargeView);
1019
+ import { TUICallKitAPI, LayoutMode } from "@trtc/calls-uikit-vue";
1020
+ TUICallKitAPI.setLayoutMode(LayoutMode.LocalInLargeView);
1074
1021
  ```
1075
1022
 
1076
1023
 
1077
1024
  【React】
1078
1025
  ``` javascript
1079
- import { TUICallKitServer, LayoutMode } from "@tencentcloud/call-uikit-react";
1080
- TUICallKitServer.setLayoutMode(LayoutMode.LocalInLargeView);
1026
+ import { TUICallKitAPI, LayoutMode } from "@trtc/calls-uikit-react";
1027
+ TUICallKitAPI.setLayoutMode(LayoutMode.LocalInLargeView);
1081
1028
  ```
1082
1029
 
1083
1030
  参数列表:
@@ -1107,15 +1054,8 @@ TUICallKitServer.setLayoutMode(LayoutMode.LocalInLargeView);
1107
1054
  ### setCameraDefaultState
1108
1055
 
1109
1056
  设置摄像头是否默认打开。
1110
-
1111
- > **注意:**
1112
- >
1113
-
1114
- > **v3.3.0+ 支持。**
1115
- >
1116
-
1117
1057
  ``` javascript
1118
- TUICallKitServer.setCameraDefaultState(true);
1058
+ TUICallKitAPI.setCameraDefaultState(true);
1119
1059
  ```
1120
1060
 
1121
1061
  参数列表:
@@ -1145,15 +1085,8 @@ TUICallKitServer.setCameraDefaultState(true);
1145
1085
  ### getTUICallEngineInstance
1146
1086
 
1147
1087
  获取 TUICallEngine 实例。
1148
-
1149
- > **注意:**
1150
- >
1151
-
1152
- > v2.4.3+ 支持。
1153
- >
1154
-
1155
1088
  ``` javascript
1156
- TUICallKitServer.getTUICallEngineInstance();
1089
+ TUICallKitAPI.getTUICallEngineInstance();
1157
1090
  ```
1158
1091
 
1159
1092
  ## TUICallKit 类型定义
@@ -1255,7 +1188,7 @@ TUICallKitServer.getTUICallEngineInstance();
1255
1188
 
1256
1189
  **常见问题:**
1257
1190
 
1258
- - iOS 13&14不支持编码高于 720P 的视频,建议在这两个系统版本限制最高采集 720P。参见 [iOS Safari 已知问题 case 12](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-02-info-webrtc-issues.html#h2-4)。
1191
+ - iOS 13&14不支持编码高于 720p 的视频,建议在这两个系统版本限制最高采集 720P。参见 [iOS Safari 已知问题 case 12](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-02-info-webrtc-issues.html#h2-4)。
1259
1192
 
1260
1193
  - Firefox 不支持自定义视频帧率(默认为 30fps)。
1261
1194
 
@@ -1320,22 +1253,22 @@ TUICallKitServer.getTUICallEngineInstance();
1320
1253
  </table>
1321
1254
 
1322
1255
 
1323
- ### **TUICallType**
1256
+ ### **CallMediaType**
1324
1257
  <table>
1325
1258
  <tr>
1326
- <td rowspan="1" colSpan="1" >TUICallType 类型</td>
1259
+ <td rowspan="1" colSpan="1" >CallMediaType 类型</td>
1327
1260
 
1328
1261
  <td rowspan="1" colSpan="1" >描述</td>
1329
1262
  </tr>
1330
1263
 
1331
1264
  <tr>
1332
- <td rowspan="1" colSpan="1" >TUICallType.AUDIO_CALL </td>
1265
+ <td rowspan="1" colSpan="1" >CallMediaType.AUDIO</td>
1333
1266
 
1334
1267
  <td rowspan="1" colSpan="1" >语音通话</td>
1335
1268
  </tr>
1336
1269
 
1337
1270
  <tr>
1338
- <td rowspan="1" colSpan="1" >TUICallType.VIDEO_CALL </td>
1271
+ <td rowspan="1" colSpan="1" >CallMediaType.VIDEO</td>
1339
1272
 
1340
1273
  <td rowspan="1" colSpan="1" >视频通话</td>
1341
1274
  </tr>
@@ -1401,7 +1334,7 @@ TUICallKitServer.getTUICallEngineInstance();
1401
1334
 
1402
1335
  <td rowspan="1" colSpan="1" >否</td>
1403
1336
 
1404
- <td rowspan="1" colSpan="1" >离线推送忽略 badge 计数(仅对 iOS 生效), 如果设置为 true,在 iOS 接收端,这条消息不会使 APP 的应用图标未读计数增加<br>**v3.3.0+ 支持**</td>
1337
+ <td rowspan="1" colSpan="1" >离线推送忽略 badge 计数(仅对 iOS 生效), 如果设置为 true,在 iOS 接收端,这条消息不会使 App 的应用图标未读计数增加。</td>
1405
1338
  </tr>
1406
1339
 
1407
1340
  <tr>
@@ -1411,7 +1344,7 @@ TUICallKitServer.getTUICallEngineInstance();
1411
1344
 
1412
1345
  <td rowspan="1" colSpan="1" >否</td>
1413
1346
 
1414
- <td rowspan="1" colSpan="1" >离线推送声音设置(仅对 iOS 生效)。**v3.3.0+ 支持**</td>
1347
+ <td rowspan="1" colSpan="1" >离线推送声音设置(仅对 iOS 生效)。</td>
1415
1348
  </tr>
1416
1349
 
1417
1350
  <tr>
@@ -1421,7 +1354,7 @@ TUICallKitServer.getTUICallEngineInstance();
1421
1354
 
1422
1355
  <td rowspan="1" colSpan="1" >否</td>
1423
1356
 
1424
- <td rowspan="1" colSpan="1" >离线推送声音设置(仅对 Android 生效)。**v3.3.0+ 支持**</td>
1357
+ <td rowspan="1" colSpan="1" >离线推送声音设置(仅对 Android 生效)。</td>
1425
1358
  </tr>
1426
1359
 
1427
1360
  <tr>
@@ -1431,7 +1364,7 @@ TUICallKitServer.getTUICallEngineInstance();
1431
1364
 
1432
1365
  <td rowspan="1" colSpan="1" >否</td>
1433
1366
 
1434
- <td rowspan="1" colSpan="1" >VIVO 推送消息分类。**v3.3.0+ 支持**</td>
1367
+ <td rowspan="1" colSpan="1" >VIVO 推送消息分类。</td>
1435
1368
  </tr>
1436
1369
 
1437
1370
  <tr>
@@ -1441,7 +1374,7 @@ TUICallKitServer.getTUICallEngineInstance();
1441
1374
 
1442
1375
  <td rowspan="1" colSpan="1" >否</td>
1443
1376
 
1444
- <td rowspan="1" colSpan="1" >小米手机 8.0 系统及以上的渠道 ID。**v3.3.0+ 支持**</td>
1377
+ <td rowspan="1" colSpan="1" >小米手机 8.0 系统及以上的渠道 ID。</td>
1445
1378
  </tr>
1446
1379
 
1447
1380
  <tr>
@@ -1451,7 +1384,7 @@ TUICallKitServer.getTUICallEngineInstance();
1451
1384
 
1452
1385
  <td rowspan="1" colSpan="1" >否</td>
1453
1386
 
1454
- <td rowspan="1" colSpan="1" >FCM 通道手机 8.0 系统及以上的渠道 ID。**v3.3.0+ 支持**</td>
1387
+ <td rowspan="1" colSpan="1" >FCM 通道手机 8.0 系统及以上的渠道 ID。</td>
1455
1388
  </tr>
1456
1389
 
1457
1390
  <tr>
@@ -1461,7 +1394,7 @@ TUICallKitServer.getTUICallEngineInstance();
1461
1394
 
1462
1395
  <td rowspan="1" colSpan="1" >否</td>
1463
1396
 
1464
- <td rowspan="1" colSpan="1" >华为推送消息分类。**v3.3.0+ 支持**</td>
1397
+ <td rowspan="1" colSpan="1" >华为推送消息分类。</td>
1465
1398
  </tr>
1466
1399
 
1467
1400
  <tr>
@@ -1471,7 +1404,7 @@ TUICallKitServer.getTUICallEngineInstance();
1471
1404
 
1472
1405
  <td rowspan="1" colSpan="1" >否</td>
1473
1406
 
1474
- <td rowspan="1" colSpan="1" >是否关闭推送(默认开启推送)。**v3.3.0+ 支持**</td>
1407
+ <td rowspan="1" colSpan="1" >是否关闭推送(默认开启推送)。</td>
1475
1408
  </tr>
1476
1409
 
1477
1410
  <tr>
@@ -1481,7 +1414,7 @@ TUICallKitServer.getTUICallEngineInstance();
1481
1414
 
1482
1415
  <td rowspan="1" colSpan="1" >否</td>
1483
1416
 
1484
- <td rowspan="1" colSpan="1" >iOS 离线推送类型。0-普通推送;1-VoIP推送。默认:0。**v3.3.0+ 支持**</td>
1417
+ <td rowspan="1" colSpan="1" >iOS 离线推送类型。0-普通推送;1-VoIP推送。默认:0。</td>
1485
1418
  </tr>
1486
1419
  </table>
1487
1420
 
@@ -1561,352 +1494,3 @@ offlinePushInfo.extension = JSON.stringify(extension);
1561
1494
  <td rowspan="1" colSpan="1" >远端用户在大窗显示</td>
1562
1495
  </tr>
1563
1496
  </table>
1564
-
1565
-
1566
- # 废弃接口
1567
-
1568
- ### <TUICallKitMini/>
1569
-
1570
- `<TUICallKitMini/>`:TUICallKit UI 通话悬浮窗,当`<TUICallKit :allowedMinimized="true"/>`时,`<TUICallKitMini/>`必须被放置在页面中。
1571
-
1572
- > **说明:**
1573
- >
1574
- > - `<TUICallKitMini/>`UI 通话悬浮窗,**≥ v2.3.2 废弃,不再提供该组件**。
1575
- > - 由`<TUICallKit/>` UI 通话组件主体,实现悬浮窗样式,减少使用复杂度。
1576
-
1577
- <table>
1578
- <tr>
1579
- <td rowspan="1" colSpan="1" >属性</td>
1580
-
1581
- <td rowspan="1" colSpan="1" >描述</td>
1582
-
1583
- <td rowspan="1" colSpan="1" >类型</td>
1584
-
1585
- <td rowspan="1" colSpan="1" >是否必填</td>
1586
-
1587
- <td rowspan="1" colSpan="1" >默认值</td>
1588
-
1589
- <td rowspan="1" colSpan="1" >支持 vue</td>
1590
-
1591
- <td rowspan="1" colSpan="1" >支持 react</td>
1592
- </tr>
1593
-
1594
- <tr>
1595
- <td rowspan="1" colSpan="1" ><br>@kicked-out</td>
1596
-
1597
- <td rowspan="1" colSpan="1" >**注意:**<br>**≥ v2.3.2 废弃**<br><br>组件抛出的事件,当前登录用户被踢出登录时会触发该事件,通话也会自动结束</td>
1598
-
1599
- <td rowspan="1" colSpan="1" >function()</td>
1600
-
1601
- <td rowspan="1" colSpan="1" >否</td>
1602
-
1603
- <td rowspan="1" colSpan="1" >-</td>
1604
-
1605
- <td rowspan="1" colSpan="1" >√</td>
1606
-
1607
- <td rowspan="1" colSpan="1" >×</td>
1608
- </tr>
1609
-
1610
- <tr>
1611
- <td rowspan="1" colSpan="1" ><br>@status-changed</td>
1612
-
1613
- <td rowspan="1" colSpan="1" >**注意:**<br>**≥ v2.3.2 废弃**<br><br>组件抛出的事件,当通话状态发生变化时,会触发该事件,通话状态种类详见,[STATUS 值说明](https://cloud.tencent.com/document/product/647/81015#STATUS)</td>
1614
-
1615
- <td rowspan="1" colSpan="1" >function({oldStatus, newStatus})</td>
1616
-
1617
- <td rowspan="1" colSpan="1" >否</td>
1618
-
1619
- <td rowspan="1" colSpan="1" >-</td>
1620
-
1621
- <td rowspan="1" colSpan="1" >√</td>
1622
-
1623
- <td rowspan="1" colSpan="1" >×</td>
1624
- </tr>
1625
- </table>
1626
-
1627
-
1628
- ### call
1629
-
1630
-
1631
-
1632
- 拨打 1v1 通话,**建议使用 calls 接口。**
1633
- ``` javascript
1634
- import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-react';
1635
- try {
1636
- await TUICallKitServer.call({
1637
- userID: 'mike', // username being called
1638
- type: TUICallType.VIDEO_CALL,
1639
- });
1640
- } catch (error: any) {
1641
- console.error(`[TUICallKit] Call failed. Reason: ${error}`);
1642
- }
1643
- ```
1644
-
1645
- 参数如下表所示:
1646
- <table>
1647
- <tr>
1648
- <td rowspan="1" colSpan="1" >参数</td>
1649
-
1650
- <td rowspan="1" colSpan="1" >类型</td>
1651
-
1652
- <td rowspan="1" colSpan="1" >是否必填</td>
1653
-
1654
- <td rowspan="1" colSpan="1" >含义</td>
1655
- </tr>
1656
-
1657
- <tr>
1658
- <td rowspan="1" colSpan="1" >userID</td>
1659
-
1660
- <td rowspan="1" colSpan="1" >String</td>
1661
-
1662
- <td rowspan="1" colSpan="1" >是</td>
1663
-
1664
- <td rowspan="1" colSpan="1" >被呼叫用户的用户名</td>
1665
- </tr>
1666
-
1667
- <tr>
1668
- <td rowspan="1" colSpan="1" >type</td>
1669
-
1670
- <td rowspan="1" colSpan="1" >[TUICallType](https://cloud.tencent.com/document/product/647/81015#TUICallType)</td>
1671
-
1672
- <td rowspan="1" colSpan="1" >是</td>
1673
-
1674
- <td rowspan="1" colSpan="1" >通话的媒体类型,参数值说明参见 [TUICallType 通话类型](https://write.woa.com/document/90294110881382400)<br>兼容旧版本:语音通话(type = 1)、视频通话(type = 2)</td>
1675
- </tr>
1676
-
1677
- <tr>
1678
- <td rowspan="1" colSpan="1" >roomID</td>
1679
-
1680
- <td rowspan="1" colSpan="1" >Number</td>
1681
-
1682
- <td rowspan="1" colSpan="1" >否</td>
1683
-
1684
- <td rowspan="1" colSpan="1" >数字房间号,范围 [1, 2147483647]</td>
1685
- </tr>
1686
-
1687
- <tr>
1688
- <td rowspan="1" colSpan="1" >strRoomID</td>
1689
-
1690
- <td rowspan="1" colSpan="1" >String</td>
1691
-
1692
- <td rowspan="1" colSpan="1" >否</td>
1693
-
1694
- <td rowspan="1" colSpan="1" >字符串房间号。**v3.3.1+ 支持**<br>1. roomID 与 strRoomID 是互斥的,若您选用 strRoomID,则 roomID 需要填写为 0。若两者都填,SDK 将优先选用 roomID。<br>2. 不要混用 roomID 和 strRoomID,因为它们之间是不互通的,例如数字 123 和字符串 "123" 是两个完全不同的房间。</td>
1695
- </tr>
1696
-
1697
- <tr>
1698
- <td rowspan="1" colSpan="1" >timeout</td>
1699
-
1700
- <td rowspan="1" colSpan="1" >Number</td>
1701
-
1702
- <td rowspan="1" colSpan="1" >否</td>
1703
-
1704
- <td rowspan="1" colSpan="1" >通话超时时间,默认:30s,单位:秒。timeout = 0,设置为不超时</td>
1705
- </tr>
1706
-
1707
- <tr>
1708
- <td rowspan="1" colSpan="1" >userData</td>
1709
-
1710
- <td rowspan="1" colSpan="1" >String</td>
1711
-
1712
- <td rowspan="1" colSpan="1" >否</td>
1713
-
1714
- <td rowspan="1" colSpan="1" >发起通话时自定义扩展字段,被呼叫用户在 [ON_CALL_RECEIVED](https://write.woa.com/document/86735802757361664) 事件中有该参数</td>
1715
- </tr>
1716
-
1717
- <tr>
1718
- <td rowspan="1" colSpan="1" >[offlinePushInfo](https://cloud.tencent.com/document/product/647/81015#offlinePushInfo)</td>
1719
-
1720
- <td rowspan="1" colSpan="1" >Object</td>
1721
-
1722
- <td rowspan="1" colSpan="1" >否</td>
1723
-
1724
- <td rowspan="1" colSpan="1" >自定义离线消息推送参数</td>
1725
- </tr>
1726
- </table>
1727
-
1728
-
1729
- ### groupCall
1730
-
1731
-
1732
-
1733
- 发起群组通话,**建议使用 calls 接口。**
1734
- ``` javascript
1735
- try {
1736
- await TUICallKitServer.groupCall({
1737
- userIDList: ['jack', 'tom'],
1738
- groupID: "xxx",
1739
- type: TUICallType.VIDEO_CALL
1740
- });
1741
- } catch (error: any) {
1742
- console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
1743
- }
1744
- ```
1745
-
1746
- 参数如下表所示:
1747
- <table>
1748
- <tr>
1749
- <td rowspan="1" colSpan="1" >参数</td>
1750
-
1751
- <td rowspan="1" colSpan="1" >类型</td>
1752
-
1753
- <td rowspan="1" colSpan="1" >是否必填</td>
1754
-
1755
- <td rowspan="1" colSpan="1" >含义</td>
1756
- </tr>
1757
-
1758
- <tr>
1759
- <td rowspan="1" colSpan="1" >userIDList</td>
1760
-
1761
- <td rowspan="1" colSpan="1" >Array<String></td>
1762
-
1763
- <td rowspan="1" colSpan="1" >是</td>
1764
-
1765
- <td rowspan="1" colSpan="1" >被呼叫的用户列表</td>
1766
- </tr>
1767
-
1768
- <tr>
1769
- <td rowspan="1" colSpan="1" >type</td>
1770
-
1771
- <td rowspan="1" colSpan="1" >[TUICallType](https://write.woa.com/document/90294110881382400)</td>
1772
-
1773
- <td rowspan="1" colSpan="1" >是</td>
1774
-
1775
- <td rowspan="1" colSpan="1" >通话的媒体类型,参数值说明参见 [TUICallType 通话类型](https://write.woa.com/document/90294110881382400)<br>兼容旧版本:语音通话(type = 1)、视频通话(type = 2)</td>
1776
- </tr>
1777
-
1778
- <tr>
1779
- <td rowspan="1" colSpan="1" >groupID</td>
1780
-
1781
- <td rowspan="1" colSpan="1" >String</td>
1782
-
1783
- <td rowspan="1" colSpan="1" >是</td>
1784
-
1785
- <td rowspan="1" colSpan="1" >通话群组 ID,groupID 的创建可参见 [chat-createGroup API](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#createGroup)</td>
1786
- </tr>
1787
-
1788
- <tr>
1789
- <td rowspan="1" colSpan="1" >roomID</td>
1790
-
1791
- <td rowspan="1" colSpan="1" >Number</td>
1792
-
1793
- <td rowspan="1" colSpan="1" >否</td>
1794
-
1795
- <td rowspan="1" colSpan="1" >数字房间号,范围 [1, 2147483647]</td>
1796
- </tr>
1797
-
1798
- <tr>
1799
- <td rowspan="1" colSpan="1" >strRoomID</td>
1800
-
1801
- <td rowspan="1" colSpan="1" >String</td>
1802
-
1803
- <td rowspan="1" colSpan="1" >否</td>
1804
-
1805
- <td rowspan="1" colSpan="1" >字符串房间号。**v3.3.1+ 支持**<br>1. roomID 与 strRoomID 是互斥的,若您选用 strRoomID,则 roomID 需要填写为 0。若两者都填,SDK 将优先选用 roomID。<br>2. 不要混用 roomID 和 strRoomID,因为它们之间是不互通的,例如数字 123 和字符串 "123" 是两个完全不同的房间。</td>
1806
- </tr>
1807
-
1808
- <tr>
1809
- <td rowspan="1" colSpan="1" >timeout</td>
1810
-
1811
- <td rowspan="1" colSpan="1" >Number</td>
1812
-
1813
- <td rowspan="1" colSpan="1" >否</td>
1814
-
1815
- <td rowspan="1" colSpan="1" >通话超时时间,默认:30s,单位:秒。timeout = 0,设置为不超时</td>
1816
- </tr>
1817
-
1818
- <tr>
1819
- <td rowspan="1" colSpan="1" >userData</td>
1820
-
1821
- <td rowspan="1" colSpan="1" >String</td>
1822
-
1823
- <td rowspan="1" colSpan="1" >否</td>
1824
-
1825
- <td rowspan="1" colSpan="1" >发起通话时自定义扩展字段,被呼叫用户在 [ON_CALL_RECEIVED](https://write.woa.com/document/86735802757361664) 事件中有该参数</td>
1826
- </tr>
1827
-
1828
- <tr>
1829
- <td rowspan="1" colSpan="1" >[offlinePushInfo](https://cloud.tencent.com/document/product/647/81015#offlinePushInfo)</td>
1830
-
1831
- <td rowspan="1" colSpan="1" >Object</td>
1832
-
1833
- <td rowspan="1" colSpan="1" >否</td>
1834
-
1835
- <td rowspan="1" colSpan="1" >自定义离线消息推送参数</td>
1836
- </tr>
1837
- </table>
1838
-
1839
-
1840
- ### joinInGroupCall
1841
-
1842
-
1843
-
1844
- 加入群组中已有的音视频通话,**建议使用 join 接口。**
1845
-
1846
- > **注意:**
1847
- >
1848
-
1849
- > **v3.1.2+ 支持。**
1850
- >
1851
-
1852
-
1853
- > **说明:**
1854
- >
1855
- > - 加入群组中已有的音视频通话前,需要提前创建或加入IM 群组,并且群组中已有用户在通话中,如果已经创建,请忽略。
1856
- > - 群组的创建详见: [IM 群组管理](https://cloud.tencent.com/document/product/269/75395#.E5.88.9B.E5.BB.BA.E7.BE.A4.E7.BB.84) ,或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/68493),一站式集成聊天、通话等场景。
1857
-
1858
- ``` javascript
1859
- try {
1860
- const params = {
1861
- type: TUICallType.VIDEO_CALL,
1862
- groupID: "xxx",
1863
- roomID: 0,
1864
- };
1865
- await TUICallKitServer.joinInGroupCall(params);
1866
- } catch (error: any) {
1867
- console.error(`[TUICallKit] Failed to call the enableMuteMode API. Reason: ${error}`);
1868
- }
1869
- ```
1870
-
1871
- 参数列表:
1872
- <table>
1873
- <tr>
1874
- <td rowspan="1" colSpan="1" >参数</td>
1875
-
1876
- <td rowspan="1" colSpan="1" >类型</td>
1877
-
1878
- <td rowspan="1" colSpan="1" >是否必填</td>
1879
-
1880
- <td rowspan="1" colSpan="1" >含义</td>
1881
- </tr>
1882
-
1883
- <tr>
1884
- <td rowspan="1" colSpan="1" >type</td>
1885
-
1886
- <td rowspan="1" colSpan="1" >[TUICallType](https://cloud.tencent.com/document/product/647/81015#TUICallType)</td>
1887
-
1888
- <td rowspan="1" colSpan="1" >是</td>
1889
-
1890
- <td rowspan="1" colSpan="1" >通话的媒体类型,例如视频通话、语音通话</td>
1891
- </tr>
1892
-
1893
- <tr>
1894
- <td rowspan="1" colSpan="1" >groupID</td>
1895
-
1896
- <td rowspan="1" colSpan="1" >String</td>
1897
-
1898
- <td rowspan="1" colSpan="1" >是</td>
1899
-
1900
- <td rowspan="1" colSpan="1" >此次群组通话的群 ID</td>
1901
- </tr>
1902
-
1903
- <tr>
1904
- <td rowspan="1" colSpan="1" >roomID</td>
1905
-
1906
- <td rowspan="1" colSpan="1" >number</td>
1907
-
1908
- <td rowspan="1" colSpan="1" >是</td>
1909
-
1910
- <td rowspan="1" colSpan="1" >此次通话的音视频房间 ID</td>
1911
- </tr>
1912
- </table>