本文介绍自定义铃声、静音来电铃声功能的使用。
自定义来电铃声
设置铃声接口
Web&H5 端 | 小程序端 |
仅限传入本地 MP3 格式的文件地址，确保该文件可以访问的。 如需恢复默认铃声 filePath 传空即可。 使用 ES6 import 方式引入铃声文件。 | 传入本地铃声文件应为相对当前小程序项目的绝对路径。 uni-app 打包 Vue2 项目没有铃声，具体参见：
Vue2 uni-app 打包微信小程序项目中，铃声没有声音？? |
说明：Vue ≥ v3.0.0 支持
importfilePathfrom'../public/ring.mp3';?try {await TUICallKitServer.setCallingBell(filePath?: string);} catch (error: any) {alert(`[TUICallKit] setCallingBell API failed. Reason: ${error}`);}
try {await TUICallKitServer.setCallingBell('/static/ring.mp3'); // 相对当前小程序项目的绝对路径} catch (error: any) {alert(`[TUICallKit] setCallingBell API failed. Reason: ${error}`);}
替换音频文件
如果您通过源码集成 TUICallKit 组件，通过替换铃声文件来达到替换铃声的目的。
uni-app 小程序：替换
'TUICallKit/src/TUICallService/assets/' 文件。微信小程序：替换
'TUICallKit/static/' 文件。文件名 | 用途 |
phone_dialing.mp3 | 发起呼叫时的铃音 |
phone_ringing.mp3 | 接到呼叫时的铃音 |
静音来电铃声
开启/关闭来电铃声。
开启后，收到通话请求时，不会播放来电铃声。
说明：Vue&WeChat ≥ v3.1.2 支持
try {await TUICallKitServer.enableMuteMode(enable: boolean)；} catch (error: any) {alert(`[TUICallKit] enableMuteMode API failed. Reason: ${error}`);}
