自定义铃声

更新时间: 2024/08/23 10:16:57

本文介绍在呼叫组件中如何自定义呼叫铃声,包括被叫铃声、呼叫等待铃声等。

功能介绍

NERingFile 类主要用于设置呼叫等待时、被叫时的铃声。

  • 只有带UI的呼叫组件支持自定义铃声,不带UI的呼叫组件铃声需要业务自行实现。
  • 提前加入 RTC 的模式不支持铃声,请引入 UI 组件源码自行实现。

实现方法

如果您希望自定义呼叫组件中用户的响铃,请在初始化呼叫组件时,设置 NERingFile 对象和铃声路径。

操作步骤

  1. 将自定义铃声放在工程文件夹下。

  2. pathForResource 方法中获取铃声的存放路径。

    可以设置不同场景的铃声,具体如下:

    类型 说明
    callerRingFilePath 主叫呼叫提示铃声
    calleeRingFilePath 被叫收到邀请提示铃声
    rejectRingFilePath 拒绝提示铃声
    busyRingFilePath 忙线提示铃声
    noResponseFilePath 无响应提示铃声
  3. 调用 UI 组件单例赋值给暴露出来的路径变量(具体参考示例代码)。

  4. (可选)自实现铃声播放。

    主叫提前加入房间的配置下,实现铃声播放存在一些限制,可以根据业务需求自行实现此场景下的铃声播放。

    呼叫组件 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
此文档是否对你有帮助?
有帮助
去反馈
  • 功能介绍
  • 实现方法
  • 操作步骤
  • 示例代码