@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/knowledge/callkit/preset/android/api.md

@@ -0,0 +1,413 @@
+## TUICallKit API 简介
+
+TUICallKit API 是音视频通话组件的**含 UI 接口**，使用 TUICallKit API，您可以通过简单接口快速实现一个类微信的音视频通话场景，更详细的接入步骤，详情请参见 [快速接入TUICallKit](https://cloud.tencent.com/document/product/647/78729)。
+
+## API 概览
+
+|API|描述|
+|---------|---------|
+|createInstance|创建 TUICallKit 实例（单例模式）。|
+|setSelfInfo|设置用户的头像、昵称。|
+|calls|发起单人或多人通话。|
+|join|主动加入通话。|
+|setCallingBell|设置自定义来电铃声。|
+|enableMuteMode|开启/关闭静音模式。|
+|enableFloatWindow|开启/关闭悬浮窗功能。|
+|enableIncomingBanner|开启/关闭来电横幅显示。|
+|setScreenOrientation|设置通话界面显示方向。|
+|enableVirtualBackground|设置模糊背景。|
+
+## API 详情
+
+### createInstance
+
+创建 TUICallKit 的单例。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun createInstance(context: Context): TUICallKit
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+TUICallKit createInstance(Context context);
+```
+
+### setSelfInfo
+
+设置用户昵称、头像。用户昵称不能超过500字节，用户头像必须是 URL 格式。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun setSelfInfo(nickname: String?, avatar: String?, completion: CompletionHandler?);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void setSelfInfo(String nickname, String avatar, CompletionHandler completion);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|nickname|String|目标用户的昵称。|
+|avatar|String|目标用户的头像。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### calls
+
+发起单人或多人通话。
+
+【kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+import io.trtc.tuikit.atomicxcore.api.call.CallMediaType
+import io.trtc.tuikit.atomicxcore.api.call.CallParams
+
+fun calls(
+    userIdList: List<String>, mediaType: CallMediaType,
+    params: CallParams?, completion: CompletionHandler?
+);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+import io.trtc.tuikit.atomicxcore.api.call.CallMediaType;
+import io.trtc.tuikit.atomicxcore.api.call.CallParams;
+
+void calls(List<String> userIdList, CallMediaType mediaType, CallParams params, CompletionHandler completion);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userIdList|List<String>|目标用户的 userId 列表。|
+|mediaType|[CallMediaType](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-media-type/index.html)|通话的媒体类型，例如视频通话、语音通话。|
+|params|[CallParams](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-params/index.html)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### join
+
+主动加入通话。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun join(callId: String?, completion: CompletionHandler?);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void join(String callId, CompletionHandler completion);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|callId|String|此次通话的唯一 ID。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### setCallingBell
+
+设置自定义来电铃声。
+
+这里仅限传入本地文件地址，需要确保该文件目录是应用可以访问的。
+- 铃声设置后与设备绑定，更换用户，铃声依旧会生效。
+
+- 如需恢复默认铃声，`filePath`传空即可。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun setCallingBell(filePath: String?);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void setCallingBell(String filePath);
+```
+
+### enableMuteMode
+
+开启/关闭静音模式。
+
+默认为`false`，开启后，收到通话请求，不会播放来电铃声。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun enableMuteMode(enable: Boolean);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void enableMuteMode(boolean enable);
+```
+
+### enableFloatWindow
+
+开启/关闭悬浮窗功能。
+
+默认为`false`，通话界面左上角的悬浮窗按钮隐藏，设置为 true 后显示。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun enableFloatWindow(enable: Boolean);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void enableFloatWindow(boolean enable);
+```
+
+### enableIncomingBanner
+
+开启/关闭来电横幅显示。
+
+默认为`false`，被叫端收到邀请后默认弹出全屏通话等待界面。开启后先展示一个横幅，然后根据需要拉起全屏通话界面。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun enableIncomingBanner(enable: Boolean);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void enableIncomingBanner(boolean enable);
+```
+
+### setScreenOrientation
+
+设置通话界面显示方向。
+
+默认为竖屏，orientation：0-Portrait、1-LandScape、2-Auto。
+
+【Kotlin】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun setScreenOrientation(orientation: Int);
+```
+
+【Java】
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;
+
+void setScreenOrientation(int orientation);
+```
+
+### enableVirtualBackground
+
+设置模糊背景。
+
+默认值为：false。
+``` java
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+
+fun enableVirtualBackground(enable: Boolean);
+```
+
+## 废弃接口
+
+### call
+
+拨打电话（1v1通话）。
+
+> **注意：**
+>
+
+> **v2.9+版本废弃，建议使用 **[calls](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/calls.html)** 接口。**
+>
+
+【Kotlin】
+``` java
+fun call(userId: String, mediaType: TUICallDefine.MediaType)
+```
+
+【Java】
+``` java
+ void call(String userId, TUICallDefine.MediaType mediaType)
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userId|String|目标用户的 userId。|
+|mediaType|[TUICallDefine.MediaType](https://cloud.tencent.com/document/product/647/127619#MediaType)|通话的媒体类型，例如视频通话、语音通话。|
+
+### call
+
+拨打电话（1v1通话），支持自定义房间号、通话邀请超时时间，离线推送内容等。
+
+> **注意：**
+>
+
+> **v2.9+版本废弃，建议使用 **[calls](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/calls.html)** 接口。**
+>
+
+【Kotlin】
+``` java
+fun call(
+    userId: String, mediaType: TUICallDefine.MediaType,
+    params: CallParams?, callback: TUICommonDefine.Callback?
+)
+```
+
+【Java】
+``` java
+ void call(String userId, TUICallDefine.MediaType mediaType,
+           TUICallDefine.CallParams params, TUICommonDefine.Callback callback)
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userId|String|目标用户的 userId。|
+|mediaType|[TUICallDefine.MediaType](https://cloud.tencent.com/document/product/647/127619#MediaType)|通话的媒体类型，例如视频通话、语音通话。|
+|params|[TUICallDefine.CallParams](https://cloud.tencent.com/document/product/647/127619#CallParams)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+
+### groupCall
+
+发起群组通话。
+
+> **注意：**
+>
+> - **v2.9+版本废弃，建议使用 **[calls](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/calls.html)** 接口。**
+> - 使用群组通话前需要创建 IM 群组，如果已经创建，请忽略。
+> - 群组的创建详见：[IM 群组管理](https://cloud.tencent.com/document/product/269/75394) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/37059)，一站式集成聊天、通话等场景。
+
+【Kotlin】
+``` java
+fun groupCall(groupId: String, userIdList: List<String?>?, mediaType: TUICallDefine.MediaType)
+```
+
+【Java】
+``` java
+void groupCall(String groupId, List<String> userIdList, TUICallDefine.MediaType mediaType);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|groupId|String|此次群组通话的群 ID。|
+|userIdList|List|目标用户的 userId 列表。|
+|mediaType|[TUICallDefine.MediaType](https://cloud.tencent.com/document/product/647/127619#MediaType)|通话的媒体类型，例如视频通话、语音通话。|
+
+### groupCall
+
+发起群组通话，支持自定义房间号、通话邀请超时时间，离线推送内容等。
+
+> **注意：**
+>
+> - **v2.9+版本废弃，建议使用 **[calls](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/calls.html)** 接口。**
+> - 使用群组通话前需要创建 IM 群组，如果已经创建，请忽略。
+> - 群组的创建详见：[IM 群组管理](https://cloud.tencent.com/document/product/269/75394) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/37059)，一站式集成聊天、通话等场景。
+
+【Kotlin】
+``` java
+fun groupCall(
+    groupId: String, userIdList: List<String?>?, mediaType: TUICallDefine.MediaType,
+    params: CallParams?, callback: TUICommonDefine.Callback?
+)
+```
+
+【Java】
+``` java
+void groupCall(String groupId, List<String> userIdList, TUICallDefine.MediaType mediaType,
+               TUICallDefine.CallParams params, TUICommonDefine.Callback callback);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|groupId|String|此次群组通话的群 ID。|
+|userIdList|List|目标用户的 userId 列表。|
+|mediaType|[TUICallDefine.MediaType](https://cloud.tencent.com/document/product/647/127619#MediaType)|通话的媒体类型，例如视频通话、语音通话。|
+|params|[TUICallDefine.CallParams](https://cloud.tencent.com/document/product/647/127619#CallParams)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+
+### joinInGroupCall
+
+加入群组中已有的音视频通话。
+
+> **注意：**
+>
+> - **v2.9+版本废弃，建议使用 **[join](https://liteav.sdk.cloudcachetci.com/doc/product/tuikit/atomic-x/android/zh/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.call/-call-store/join.html)** 接口。**
+> - 加入群组中已有的音视频通话前，需要提前创建或加入 IM 群组，并且群组中已有用户在通话中，如果已经创建，请忽略。
+> - 群组的创建详见：[IM 群组管理](https://cloud.tencent.com/document/product/269/75394) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/37059)，一站式集成聊天、通话等场景。
+
+【Kotlin】
+``` java
+fun joinInGroupCall(roomId: RoomId?, groupId: String?, mediaType: TUICallDefine.MediaType?)
+```
+
+【Java】
+``` java
+void joinInGroupCall(TUICommonDefine.RoomId roomId, String groupId, TUICallDefine.MediaType callMediaType);
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|roomId|[TUICommonDefine.RoomId](https://cloud.tencent.com/document/product/647/127619#RoomId)|此次通话的音视频房间 ID。|
+|groupId|String|此次群组通话的群 ID。|
+|mediaType|[TUICallDefine.MediaType](https://cloud.tencent.com/document/product/647/127619#MediaType)|通话的媒体类型，例如视频通话、语音通话。|
+
+### disableControlButton
+
+隐藏指定按钮。
+
+> **说明：**
+>
+> - 目前支持隐藏以下按钮：
+
+> Camera（摄像头）、Microphone（麦克风）、AudioDevice（音频设备）、SwitchCamera（切换摄像头）、InviteUser（邀请用户）。
+>
+> - **v3.2.+** 版本支持。
+
+【Kotlin】
+``` java
+fun disableControlButton(button: Constants.ControlButton?)
+```
+
+【Java】
+``` java
+void disableControlButton(Constants.ControlButton button);
+```
+
+|参数|类型|说明|
+|---------|---------|---------|
+|button|ControlButton|需要隐藏的按钮。|

package/resource/knowledge/callkit/preset/flutter/api.md

@@ -0,0 +1,22 @@
+## TUICallKit（含 UI 接口）
+
+TUICallKit API 是音视频通话组件的**含 UI 接口**，使用 TUICallKit API，您可以通过简单接口快速实现一个类微信的音视频通话场景。
+
+|API|描述|
+|---------|---------|
+|login|登录。|
+|logout|登出。|
+|setSelfInfo|设置用户的昵称、头像。|
+|calls|发起通话。|
+|join|主动加入通话。|
+|enableMuteMode|开启/关闭静音模式。|
+|enableFloatWindow|开启/关闭悬浮窗功能。|
+|enableIncomingBanner|开启/关闭来电横幅。|
+
+## 关键类型定义
+
+|类型|描述|
+|---------|---------|
+|CallMediaType|通话类型。|
+|CallParams|通话扩展参数。|
+|CompletionHandler|调用 API 的返回值。|

package/resource/knowledge/callkit/preset/ios/api.md

@@ -0,0 +1,256 @@
+## TUICallKit API 简介
+
+TUICallKit API 是音视频通话组件的**含 UI 接口**，使用TUICallKit API，您可以通过简单接口快速实现一个类微信的音视频通话场景，更详细的接入步骤，详情请参见 [快速接入TUICallKit](https://cloud.tencent.com/document/product/647/78730)。
+
+## API 概览
+
+|API|描述|
+|---------|---------|
+|createInstance|创建 TUICallKit 实例（单例模式）。|
+|setSelfInfo|设置用户的昵称、头像。|
+|calls|发起单人或多人通话。|
+|join|主动加入通话。|
+|setCallingBell|设置自定义来电铃音。|
+|enableMuteMode|开启/关闭静音模式。|
+|enableFloatWindow|开启/关闭悬浮窗功能。|
+|enableIncomingBanner|开启/关闭来电横幅显示。|
+|enableAITranscriber|开启/关闭 AI 实时转录与翻译。|
+|setScreenOrientation|设置屏幕方向。|
+
+## API 详情
+
+### createInstance
+
+创建 TUICallKit 的单例。
+
+【Swift】
+``` swift
+public static func createInstance() -> TUICallKit
+```
+
+### setSelfInfo
+
+设置用户昵称、头像。用户昵称不能超过500字节，用户头像必须是 URL 格式。
+
+【Swift】
+``` swift
+public func setSelfInfo(nickname: String, avatar: String, completion: CompletionClosure?)
+```
+
+|参数|类型|含义|
+|---------|---------|---------|
+|nickname|String|用户昵称。|
+|avatar|String|用户头像（格式为 URL）。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### calls
+
+发起通话。
+
+【Swift】
+``` swift
+public func calls(userIdList: [String], callMediaType: CallMediaType, params: CallParams?, completion: CompletionClosure?)
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userIdList| [String]|目标用户的 userId 列表。|
+|callMediaType|[CallMediaType](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callmediatype)|通话的媒体类型，比如视频通话、语音通话。|
+|params|[CallParams](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callparams)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### join
+
+主动加入通话。
+
+【Swift】
+``` swift
+public func join(callId: String, completion: CompletionClosure?)
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|callId|String|此次通话的唯一 ID。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+### setCallingBell
+
+设置自定义来电铃音。
+这里仅限传入本地文件地址，需要确保该文件目录是应用可以访问的。
+- 铃声设置后与设备绑定，更换用户，铃声依旧会生效。
+
+- 如需恢复默认铃声，`filePath` 传空即可。
+
+【Swift】
+``` swift
+public func setCallingBell(filePath: String)
+```
+
+### enableMuteMode
+
+开启/关闭静音模式。
+
+默认为 `false`，开启后，收到通话请求，不会播放来电铃声。
+
+【Swift】
+``` swift
+public func enableMuteMode(enable: Bool)
+```
+
+### enableFloatWindow
+
+开启/关闭悬浮窗功能。
+
+默认为 `false`，通话界面左上角的悬浮窗按钮隐藏，设置为 true 后显示。
+
+【Swift】
+``` swift
+public func enableFloatWindow(enable: Bool)
+```
+
+### enableIncomingBanner
+
+开启/关闭来电横幅显示。
+
+默认为`false`，被叫端收到邀请后默认弹出全屏通话等待界面，开启后先展示一个横幅，然后根据需要拉起全屏通话界面。
+``` swift
+public func enableIncomingBanner(enable: Bool)
+```
+
+### enableAITranscriber
+
+开启/关闭 AI 实时转录与翻译。
+
+默认为`true`，被叫端收到邀请后默认弹出全屏通话等待界面，开启后先展示一个横幅，然后根据需要拉起全屏通话界面。
+``` swift
+public func enableAITranscriber(enable: Bool)
+```
+
+### setScreenOrientation
+
+设置屏幕方向。
+``` swift
+public func setScreenOrientation(orientation: Int, completion: CompletionClosure?)
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|orientation|Int|屏幕方向适配：0-纵向固定（Portrait），1-横向固定（Landscape），2-自动旋转（Auto）。|
+|completion|CompletionClosure|异步操作的结果回调。|
+
+## 废弃接口
+
+### call
+
+拨打电话（1v1通话）。
+
+> **注意：**
+>
+
+> **建议使用 **[calls](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callstore/calls(participantids:callmediatype:params:completion:))** 接口。**
+>
+
+【Swift】
+``` swift
+public func call(userId: String, callMediaType: TUICallMediaType)
+```
+
+【Objective-C】
+``` java
+
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userId|String|目标用户的 userId。|
+|callMediaType|[TUICallMediaType](https://cloud.tencent.com/document/product/647/127614#TUICallMediaType)|通话的媒体类型，比如视频通话、语音通话。|
+
+### call
+
+拨打电话（群组通话），支持自定义房间号、通话邀请超时时间，离线推送内容等。
+
+> **注意：**
+>
+
+> **建议使用 **[calls](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callstore/calls(participantids:callmediatype:params:completion:))** 接口。**
+>
+
+【Swift】
+``` swift
+public func call(userId: String, callMediaType: TUICallMediaType, params: TUICallParams,
+                     succ: @escaping TUICallSucc, fail: @escaping TUICallFail)
+```
+
+【Objective-C】
+``` objectivec
+- (void)call:(NSString *)userId callMediaType:(TUICallMediaType)callMediaType params:(TUICallParams *)params succ:(TUICallSucc __nullable)succ fail:(TUICallFail __nullable)fail;
+```
+
+参数如下表所示：
+
+|参数|类型|含义|
+|---------|---------|---------|
+|userId|String|目标用户的 userId。|
+|callMediaType|[TUICallMediaType](https://cloud.tencent.com/document/product/647/127614#TUICallMediaType)|通话的媒体类型，比如视频通话、语音通话。|
+|params|[TUICallParams](https://cloud.tencent.com/document/product/647/127614#TUICallParams)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+|succ|TUICallSucc|成功回调。|
+|fail|TUICallFail|失败回调。|
+
+### groupCall
+
+> **注意：**
+>
+> - **建议使用 **[calls](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callstore/calls(participantids:callmediatype:params:completion:))** 接口。**
+> - 使用群组通话前需要创建 IM 群组，如果已经创建，请忽略。
+> - 群组的创建详见：[IM 群组管理](https://cloud.tencent.com/document/product/269/75394#.E5.88.9B.E5.BB.BA.E7.BE.A4.E7.BB.84) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/37059)，一站式集成聊天、通话等场景。
+
+【Swift】
+``` swift
+public func groupCall(groupId: String, userIdList: [String], callMediaType: TUICallMediaType)
+```
+
+【Objective-C】
+``` objectivec
+- (void)groupCall:(NSString *)groupId userIdList:(NSArray<NSString *> *)userIdList callMediaType:(TUICallMediaType)callMediaType;
+```
+
+|参数|类型|含义|
+|---------|---------|---------|
+|groupId|String|此次群组通话的群 ID。|
+|userIdList|[String]|目标用户的 userId 列表。|
+|callMediaType|[TUICallMediaType](https://cloud.tencent.com/document/product/647/127614#TUICallMediaType)|通话的媒体类型，比如视频通话、语音通话。|
+|params|[TUICallParams](https://cloud.tencent.com/document/product/647/127614#TUICallParams)|通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。|
+|succ|TUICallSucc|成功回调。|
+|fail|TUICallFail|失败回调。|
+
+### joinInGroupCall
+
+> **注意：**
+>
+> - **建议使用 **[join](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callstore/join(callid:completion:))** 接口。**
+> - 加入群组中已有的音视频通话前，需要提前创建或加入 IM 群组，并且群组中已有用户在通话中，如果已经创建，请忽略。
+> - 群组的创建详见：[IM 群组管理](https://cloud.tencent.com/document/product/269/75394#.E5.88.9B.E5.BB.BA.E7.BE.A4.E7.BB.84) ，或者您也可以直接使用 [IM TUIKit](https://cloud.tencent.com/document/product/269/37059)，一站式集成聊天、通话等场景。
+
+【Swift】
+``` swift
+public func joinInGroupCall(roomId: TUIRoomId, groupId: String, callMediaType: TUICallMediaType)
+```
+
+【Objective-C】
+``` objectivec
+- (void)joinInGroupCall:(TUIRoomId *)roomId groupId:(NSString *)groupId callMediaType:(TUICallMediaType)callMediaType;
+```
+
+|参数|类型|含义|
+|---------|---------|---------|
+|roomId|[TUIRoomId](https://cloud.tencent.com/document/product/647/127614#TUIRoomId)|此次通话的音视频房间 ID。|
+|groupId|String|此次群组通话的群 ID。|
+|callMediaType|[TUICallMediaType](https://cloud.tencent.com/document/product/647/127614#TUICallMediaType)|通话的媒体类型，比如视频通话、语音通话。|