离线唤醒功能,能够让您的 App 在后台运行或者离线状态下依然能够收到音视频通话的响铃呼叫,TUICallKit Flutter 需要依赖厂商: Apple、Google、Vivo、Xiaomi 提供的推送能力来进行消息通知。
配置离线推送
1. iOS
iOS 平台的离线唤醒支持
APNs
和VoIP
具体配置流程请参考:2. Android
自定义离线消息内容
在基础的离线推送配置成功后,您就可以正常收到对来电推送,如果您需要自定义离线消息的内容,可通过
call
和 groupcall
接口中的参数 params
中的TUIOfflinePushInfo
实现自定义通知内容,可以自定义的内容包括标题、内容、离线消息铃声等内容。具体使用如下:Future<void> call(String userId, TUICallMediaType callMediaType, [TUICallParams? params])class TUICallParams {TUIOfflinePushInfo offlinePushInfo; // 离线消息信息}class TUIOfflinePushInfo {String? title; //离线消息titleString? desc; //离线消息内容bool? ignoreIOSBadge;String? iOSSound; //iOS离线消息铃声String? androidSound; //Android离线消息铃声String? androidOPPOChannelID; //OPPO离线消息参数int? androidVIVOClassification; //VIVO离线消息参数String? androidXiaoMiChannelID; //小米离线消息参数String? androidFCMChannelID; //FCM参数String? androidHuaWeiCategory; //华为离线消息参数bool? isDisablePush; //是否开启离线推送TUICallIOSOfflinePushType? iOSPushType; //离线消息类型}}enum TUICallIOSOfflinePushType {APNs,VoIP,}
自定义离线消息铃声
1. iOS
修改
call
和groupcall
接口中的参数params
中的TUIOfflinePushInfo.iOSSound
设置iOS
平台上的离线消息铃声。2. Android
FCM
配置 FCM 的自定义铃音,需要在注册推送服务之前调用。
示例代码:
TencentCloudChatPush().configFCMPrivateRing(channelId: channelId, ringName: ringName, enable: enable);
参数说明:
参数名 | 类型 | 说明 |
channelId | String | FCM 通道自定义通知栏的 channel ID,应用内唯一。 |
ringName | String | FCM 通道自定义通知栏的推送铃音名称,raw 目录下铃音且不需要后缀名。 |
enable | bool | 设置离线推送提示铃音是否使用自定义铃音。 |
注意:
配置打开后,自定义铃音生效,发送方发送消息的离线信息中需要带上该 channelId。
联系我们
如遇到该问题,需要做兼容处理,您可以加入我们的 QQ 群(605115878)进行咨询与反馈。