本文介绍自定义铃声、静音来电铃声功能的使用。
自定义来电铃声
设置铃声接口
Web&H5 端 | 小程序端 |
仅限传入本地 MP3 格式的文件地址,确保该文件可以访问的。 如需恢复默认铃声 filePath 传空即可。 使用 ES6 import 方式引入铃声文件。 | 传入本地铃声文件应为相对当前小程序项目的绝对路径。 uni-app 打包 Vue2 项目没有铃声,具体参见:
Vue2 uni-app 打包微信小程序项目中,铃声没有声音? |
说明:
Vue ≥ v3.0.0 支持。
import
filePath
from
'./static/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}`);}