有奖捉虫:云通信与企业服务文档专题,速来> HOT
离线唤醒功能,能够让您的 App 在后台运行或者离线状态下依然能够收到音视频通话的响铃呼叫,TUICallKit Flutter 需要依赖厂商: Apple、Google、Vivo、Xiaomi 提供的推送能力来进行消息通知。

配置离线推送

1. iOS

iOS 平台的离线唤醒支持APNsVoIP具体配置流程请参考:

2. Android

Android 平台具体配置流程,请参考:离线推送(Flutter)

自定义离线消息内容

在基础的离线推送配置成功后,您就可以正常收到对来电推送,如果您需要自定义离线消息的内容,可通过callgroupcall 接口中的参数 params 中的TUIOfflinePushInfo实现自定义通知内容,可以自定义的内容包括标题内容离线消息铃声等内容。具体使用如下:
Future<void> call(String userId, TUICallMediaType callMediaType, [TUICallParams? params])

class TUICallParams {
TUIOfflinePushInfo offlinePushInfo; // 离线消息信息
}

class TUIOfflinePushInfo {
String? title; //离线消息title
String? 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

修改callgroupcall接口中的参数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)进行咨询与反馈。