实时音视频
视频服务与安全产品捉虫活动邀您参加！> HOT
文档中心>实时音视频>视频通话（含 UI）>离线唤醒（TUICallKit）>uni-app (客户端)

uni-app (客户端)

最近更新时间：2024-10-22 16:39:11

我的收藏

本页目录：

本文档将详细介绍如何结合 TUICallKit 组件和 TIMPush 推送插件，以实现音视频通话的离线推送能力。
应用在后台时或离线时
锁屏时



准备条件

1. 开通推送插件

进入 IM 控制台 > 插件市场，单击立即购买或免费试用 。（每个应用可免费试用一次，有效期7天。）



注意：
推送插件试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）。为避免影响您业务正常使用，请提前 购买/续费。

2. 厂商配置

说明：
uniapp 厂商配置包含 Android 厂商配置 和 iOS 厂商配置， 可参见 厂商配置 - uniapp。

3. 升级 @tencentcloud/chat 到最新版本

说明：
@tencentcloud/chat 向下兼容，可放心升级。如果您当前用的是 tim-js-sdk 或 tim-wx-sdk，请参见我们的 升级指引。
npm install @tencentcloud/chat@latest
在 HBuilder 日志中查看 TencentCloudChat.VERSION 版本号，来确认 @tencentcloud/chat ≥ 3.2.5 如图所示：




集成 TencentCloud-TIMPush 插件

步骤一: manifest.json App 模块配置

在项目 manifest.json > App 模块配置中配置消息推送模块，如图所示：




步骤二: 引入 TencentCloud-TIMPush 云打包服务，填写相关参数

1. 前往插件市场，开通 TencentCloud-TIMPush 云打包服务。如图所示：
注意：
1. 插件市场开通云打包服务项目的 appId 需要和项目 manifest.json 中的 appid 一致。
2. 开通云打包服务的 TencentCloud-TIMPush 仅用于一个项目。仅与项目有关。



2. 在项目的 manifest.json > App 原生插件配置 > 云端插件中勾选 TencentCloud-TIMPush，并设置相关参数。
注意：
1. 注意在 HBuilderX 中参数可能会出现乱序现象，请仔细认真填写。
2. 各个参数为必填项，否则会编译错误，默认为 0。
com.hihonor.push.app_id
com.vivo.push.app_id && com.vivo.push.api_key
TIMPushAppGroupID
说明：
com.hihonor.push.app_id 对应 hihonor 的 appID。
不启用 hihonor 推送时，com.hihonor.push.app_id 默认设置为 0 即可。
控制台配置
manifest.json 荣耀配置






说明：
com.vivo.push.api_id 对应 vivo 的 appID。
com.vivo.push.api_key 对应 vivo 的 appKey。
不启用 vivo 推送时，com.vivo.push.api_id 和 com.vivo.push.api_key 默认设置为 0 即可。
控制台配置
manifest.json vivo 配置






TIMPushAppGroupID 对应 iOS 的 appGroupID，它是 iOS 的触达上报的配置项，可参考 configuring-app-groups 生成 appGroupID。
注意：
不配置 TIMPushAppGroupID 不会影响正常推送功能。
不启动 iOS 的触达上报时，TIMPushAppGroupID 默认设置为 0 即可；
iOS appGroupID 生成指引
manifest.json iOS 配置
可参见 configuring-app-groups 生成 appGroupID




步骤三: manifest.json Android 权限配置

在项目的 manifest.json > 源码视图 > app-plus > distribute > android > permissions 中追加以下权限项，如图所示：
"<uses-permission android:name=\\"android.permission.INTERNET\\" />",
"<uses-permission android:name=\\"android.permission.ACCESS_NETWORK_STATE\\" />",
"<uses-permission android:name=\\"android.permission.ACCESS_WIFI_STATE\\" />",
"<uses-permission android:name=\\"android.permission.WRITE_EXTERNAL_STORAGE\\" />"




步骤四: 注册 TencentCloud-TIMPush

注意：
@tencentcloud/chat ≥ 3.2.5 支持 TencentCloud-TIMPush。
androidConfig 是 Android 推送配置，如不需要打包 Android App，可传空。
iOSConfig 是 iOS 推送配置，如不需要打包 iOS App， 可传空。
获取 Android 配置 timpush-configs.json
获取 iOS 配置 iOSBusinessID
timpush-configs.json 可以在 IM控制台 > 推送 > 接入设置 进行下载, 并将 timpush-configs.json 放入 App.vue 同级目录中， 如图所示：






iOS iOSBusinessID 可以在 IM 控制台 > 推送 > 接入设置获取，如图所示：



引入插件
登录插件
在 App.vue 中引入 TencentCloud-TIMPush，并挂载到 uni 上。
在 App.vue 中引入 timpush-configs.json，并挂载到 uni 上。
在 App.vue 中引入 TUILogin，并挂载到 uni 上。
// #ifdef APP-PLUS
import { TUILogin } from "@tencentcloud/tui-core";  // npm i @tencentcloud/tui-core
import TIMPushConfigs from "./timpush-configs.json";
const TIMPush = uni.requireNativePlugin("TencentCloud-TIMPush");
console.warn(`TencentCloud-TIMPush: uni.requireNativePlugin ${!!TIMPush ? 'success' : 'fail'}`);
uni.$TIMPush = TIMPush;
uni.$TIMPushConfigs = TIMPushConfigs || {};
uni.$TUILogin = TUILogin;
// #endif
确认 uni.requireNativePlugin 引入 TencentCloud-TIMPush 成功，如图所示：



1. 登录 TencentCloud-TIMPush 插件。
uni.$TUILogin.login({
    SDKAppID: 0, // 接入时需要将0替换为您的即时通信应用的 SDKAppID
    userID: '',
    // UserSig 是用户登录即时通信 IM 的密码，其本质是对 UserID 等信息加密后得到的密文。
    // 该方法仅适合本地跑通 Demo 和功能调试，详情请参见 https://cloud.tencent.com/document/product/269/32688     
    userSig: '', 
    // 如果您需要发送图片、语音、视频、文件等富媒体消息，请设置为 true
    useUploadPlugin: true,
    framework: `vue${vueVersion}` // 当前开发使用框架 vue2 / vue3
    TIMPush: uni.$TIMPush, // APP 注册推送插件
    pushConfig: {
        androidConfig: uni.$TIMPushConfigs,   // Android 推送配置，如不需要可传空。
        iOSConfig: {    
          "iOSBusinessID": "" // iOS 推送配置，如不需要可传空。
        }    
    }
})
2. 登录 TUICallKit 插件。
uni.$TUICallKit.login({
  SDKAppID: sdkAppId,
  userID: userID,
  userSig: userSig,
}, (res) => {
  if (res.code === 0) {
    console.log('login success');
  }
});
说明：
uni.$TUILogin.login 和 uni.$TUICallKit.login 都必须登录处理。

步骤五: 生成自定义基座

单击 HBuilderX 的运行 > 运行到手机或模拟器 > 制作自定义调试基座制作自定义基座。
注意：
配置原生插件，必须打包自定义基座进行测试。
制作基座时，Android 包名为插件开通云打包时绑定的应用包名。
证书使用云端证书。







步骤六: 运行并登录项目，确认 TencentCloud-TIMPush 集成成功。

运行时，选择自定义基座运行，在 HBuilder 的日志中，确认有 TIMPushModule._setToken ok 打印，表示 TencentCloud-TIMPush 集成成功。




步骤七: 体验您的第一条电话推送





高级功能

自定义推送内容

在调用 call、groupCall 发起通话时，可通过 callParams 字段来自定义 OfflinePushInfo 内容。



const callParams = {
  userID: 'natural',
  // 语音通话(callMediaType = 1)、视频通话(callMediaType = 2)
  callMediaType: 1, 
  callParams: {
    // offlinePushInfo 字段
    offlinePushInfo: {
      title: "test-title",
      description: "you have a call",
    }
  },  
};

uni.$TUICallKit.call(callParams, res => {} );

自定义通知铃声

注意：
接收端需集成 TencentCloud-TIMPush。
发送端 @tencentcloud/chat ≥ 3.3.2 。
支持华为、小米、FCM 和 APNS。
1. 接收端引入铃声文件。
Android
iOS
定制的铃音资源文件，添加到项目 nativeResources/android/res/raw 目录下，如图所示：



注意：
iOS 自定义铃音，uni-app 必须为正式包。
iOS 自定义铃音长度不能超过 30s。
定制的铃音资源文件，添加到项目nativeResources/ios/Resources 目录下，如图所示：



2. 配置 offlinePushInfo 字段。
说明：
androidSound 为铃声文件名，不需要后缀名。
iOSSound 为铃声文件名，需要后缀名。
const callParams = {
  userID: 'natural',
  callMediaType: 1, // 语音通话(callMediaType = 1)、视频通话(callMediaType = 2)
  callParams: {
    offlinePushInfo: {
      title: "test-title",
      description: "you have a call",
      androidSound: 'private_ring', // androidSound 为铃声文件名，不需要后缀名
      iOSSound: 'private_ring.mp3', // iOSSound为铃声文件名，需要后缀名
    }
  },
};

uni.$TUICallKit.call(callParams, res => {} );

常见问题

1. 若在集成过程中遇到问题，请务必先查阅 插件推送 > 常见问题 进行自助排查。
2. 条件说明：部分厂商要求必须上架应用市场才可以正常使用推送服务，详情参见下表：
厂商通道
是否需要上架
账号说明
小米
是
需要注册企业开发者账号
VIVO
是
需要注册企业开发者账号
OPPO
是
需要注册企业开发者账号
荣耀
否
需要注册企业开发者账号
华为
否
个人开发者账号即可
魅族
否
个人开发者账号即可

交流与反馈

如有问题，欢迎您加入我们的 TUICallKit 技术交流平台 zhiliao，进行技术交流和产品沟通。
中国站
文档反馈
文档活动
message-icon联系我们
目录