自定义铃声
更新时间: 2024/08/23 10:16:57
本文介绍在呼叫组件中如何自定义呼叫铃声,包括被叫铃声、呼叫等待铃声等。
功能介绍
NERingFile
类主要用于设置呼叫等待时、被叫时的铃声。
- 只有带UI的呼叫组件支持自定义铃声,不带UI的呼叫组件铃声需要业务自行实现。
- 提前加入 RTC 的模式不支持铃声,请引入 UI 组件源码自行实现。
实现方法
如果您希望自定义呼叫组件中用户的响铃,请在初始化呼叫组件时,设置 NERingFile
对象和铃声路径。
操作步骤
-
将自定义铃声放在工程文件夹下。
-
用
pathForResource
方法中获取铃声的存放路径。可以设置不同场景的铃声,具体如下:
类型 说明 callerRingFilePath 主叫呼叫提示铃声 calleeRingFilePath 被叫收到邀请提示铃声 rejectRingFilePath 拒绝提示铃声 busyRingFilePath 忙线提示铃声 noResponseFilePath 无响应提示铃声 -
调用 UI 组件单例赋值给暴露出来的路径变量(具体参考示例代码)。
-
(可选)自实现铃声播放。
主叫提前加入房间的配置下,实现铃声播放存在一些限制,可以根据业务需求自行实现此场景下的铃声播放。
呼叫组件 V2.2.0 版本才支持该功能。
示例代码
objc// 设置铃声路径
NSString *mp3Path = [[NSBundle mainBundle] pathForResource:@"custom" ofType:@"mp3"];
NERtcCallUIKit.sharedInstance.ringFile.callerRingFilePath = mp3Path;
// 铃声数据对象类
@interface NERingFile : NSObject
/// 主叫呼叫提示音
@property(nonatomic, strong, nullable) NSString *callerRingFilePath;
/// 被叫收到邀请提示音
@property(nonatomic, strong, nullable) NSString *calleeRingFilePath;
/// 拒绝提示音
@property(nonatomic, strong, nullable) NSString *rejectRingFilePath;
/// 忙线提示音
@property(nonatomic, strong, nullable) NSString *busyRingFilePath;
/// 无响应提示音
@property(nonatomic, strong, nullable) NSString *noResponseFilePath;
/// 初始化
- (instancetype)initWithBundle:(NSBundle *)bundle;
@end
此文档是否对你有帮助?