TRTC IOS&MAC TXAudioEffectManager

于 2024-10-23 21:30:50 发布
阅读量821 收藏 18
点赞数 7
文章标签： ios macos cocoa 云计算 音视频
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/szqcloud/article/details/143194239
版权

TRTC 背景音乐、短音效和人声特效的管理类

Module: TRTC 背景音乐、短音效和人声特效的管理类 Function: 用于对背景音乐、短音效和人声特效进行设置的管理类

音效相关的枚举值定义

enum  TXVoiceReverbType : NSInteger
enum  TXVoiceChangeType : NSInteger

背景音乐的事件回调接口

typedef void(^ TXAudioMusicStartBlock) (NSInteger errCode)
typedef void(^ TXAudioMusicProgressBlock) (NSInteger progressMs, NSInteger durationMs)
typedef void(^ TXAudioMusicCompleteBlock) (NSInteger errCode)

结构体说明

◆ TXAudioMusicParam

class TXAudioMusicParam

属性

int32_t ID
NSString * path
NSInteger loopCount
BOOL publish
BOOL isShortFile
NSInteger startTimeMS
NSInteger endTimeMS
属性说明

◆ endTimeMS

- (NSInteger) endTimeMS
readwritenonatomicassign

【字段含义】音乐结束播放时间点，单位毫秒，0表示播放至文件结尾。

◆ ID

- (int32_t) ID
readwritenonatomicassign

【字段含义】音乐 ID

【特殊说明】SDK 允许播放多路音乐，因此需要使用 ID 进行标记，用于控制音乐的开始、停止、音量等。

◆ isShortFile

- (BOOL) isShortFile
readwritenonatomicassign

【字段含义】播放的是否为短音乐文件

【推荐取值】YES：需要重复播放的短音乐文件；NO：正常的音乐文件。默认值：NO

◆ loopCount

- (NSInteger) loopCount
readwritenonatomicassign

【字段含义】音乐循环播放的次数

【推荐取值】取值范围为0 - 任意正整数，默认值：0。0表示播放音乐一次；1表示播放音乐两次；以此类推

◆ path

- (NSString*) path
readwritenonatomiccopy

【字段含义】音效文件的完整路径或 URL 地址。支持的音频格式包括 MP3、AAC、M4A、WAV

◆ publish

- (BOOL) publish
readwritenonatomicassign

【字段含义】是否将音乐传到远端

【推荐取值】YES：音乐在本地播放的同时，远端用户也能听到该音乐；NO：主播只能在本地听到该音乐，远端观众听不到。默认值：NO。

◆ startTimeMS

- (NSInteger) startTimeMS
readwritenonatomicassign

【字段含义】音乐开始播放时间点，单位：毫秒。

◆ TXAudioEffectManager

class TXAudioEffectManager

构造函数

(instancetype) - NS_UNAVAILABLE

人声相关的特效接口

(void) - enableVoiceEarMonitor:
(void) - setVoiceEarMonitorVolume:
(void) - setVoiceReverbType:
(void) - setVoiceChangerType:
(void) - setVoiceVolume:
(void) - setVoicePitch:

背景音乐的相关接口

(void) - startPlayMusic:onStart:onProgress:onComplete:
(void) - stopPlayMusic:
(void) - pausePlayMusic:
(void) - resumePlayMusic:
(void) - setAllMusicVolume:
(void) - setMusicPublishVolume:volume:
(void) - setMusicPlayoutVolume:volume:
(void) - setMusicPitch:pitch:
(void) - setMusicSpeedRate:speedRate:
(NSInteger) - getMusicCurrentPosInMS:
(NSInteger) - getMusicDurationInMS:
(void) - seekMusicToPosInMS:pts:
函数文档

◆ enableVoiceEarMonitor:()

- (void) enableVoiceEarMonitor:(BOOL) enable

开启耳返

主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。

需要您注意的是，由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。 同时也需要注意，并非所有的手机开启此特效后都能达到优秀的耳返效果，我们已经对部分耳返效果不佳的手机屏蔽了该特效。

注意

仅在主播佩戴耳机时才能开启此特效，同时请您提示主播佩戴有线耳机。

参数

enableYES：开启；NO：关闭。

◆ getMusicCurrentPosInMS:()

- (NSInteger) getMusicCurrentPosInMS:(int32_t) id

获取背景音乐的播放进度（单位：毫秒）

参数

id音乐 ID

返回

成功返回当前播放时间，单位：毫秒，失败返回-1

◆ getMusicDurationInMS:()

- (NSInteger) getMusicDurationInMS:(NSString *) path

获取背景音乐的总时长（单位：毫秒）

参数

path音乐文件路径。

返回

成功返回时长，失败返回-1

◆ NS_UNAVAILABLE()

- (instancetype) NS_UNAVAILABLE

TXAudioEffectManager对象不可直接被创建 要通过 TRTCCloud 或 TXLivePush 中的 getAudioEffectManager 接口获取

◆ pausePlayMusic:()

- (void) pausePlayMusic:(int32_t) id

暂停播放背景音乐

参数

id音乐 ID

◆ resumePlayMusic:()

- (void) resumePlayMusic:(int32_t) id

恢复播放背景音乐

参数

id音乐 ID

◆ seekMusicToPosInMS:pts:()

- (void) seekMusicToPosInMS:(int32_t) id
pts:(NSInteger) pts 

设置背景音乐的播放进度（单位：毫秒）

注意

请尽量避免过度频繁地调用该接口，因为该接口可能会再次读写音乐文件，耗时稍高。 因此，当用户拖拽音乐的播放进度条时，请在用户完成拖拽操作后再调用本接口。 因为 UI 上的进度条控件往往会以很高的频率反馈用户的拖拽进度，如不做频率限制，会导致较差的用户体验。

参数

id音乐 ID
pts单位: 毫秒

◆ setAllMusicVolume:()

- (void) setAllMusicVolume:(NSInteger) volume

设置所有背景音乐的本地音量和远端音量的大小

该接口可以设置所有背景音乐的本地音量和远端音量。

  • 本地音量：即主播本地可以听到的背景音乐的音量大小。
  • 远端音量：即观众端可以听到的背景音乐的音量大小。

参数

volume音量大小，取值范围为0 - 100，默认值：100。

注意

如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。

◆ setMusicPitch:pitch:()

- (void) setMusicPitch:(int32_t) id
pitch:(double) pitch 

调整背景音乐的音调高低

参数

id音乐 ID
pitch音调，默认值是0.0f，范围是：[-1 ~ 1] 之间的浮点数；

◆ setMusicPlayoutVolume:volume:()

- (void) setMusicPlayoutVolume:(int32_t) id
volume:(NSInteger) volume 

设置某一首背景音乐的本地音量的大小

该接口可以细粒度地控制每一首背景音乐的本地音量，也就是主播本地可以听到的背景音乐的音量大小。

参数

id音乐 ID
volume音量大小，取值范围为0 - 100，默认值：100。

注意

如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。

◆ setMusicPublishVolume:volume:()

- (void) setMusicPublishVolume:(int32_t) id
volume:(NSInteger) volume 

设置某一首背景音乐的远端音量的大小

该接口可以细粒度地控制每一首背景音乐的远端音量，也就是观众端可听到的背景音乐的音量大小。

参数

id音乐 ID
volume音量大小，取值范围为0 - 100；默认值：100

注意

如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。

◆ setMusicSpeedRate:speedRate:()

- (void) setMusicSpeedRate:(int32_t) id
speedRate:(double) speedRate 

调整背景音乐的变速效果

参数

id音乐 ID
speedRate速度，默认值是1.0f，范围是：[0.5 ~ 2] 之间的浮点数；

◆ setVoiceChangerType:()

- (void) setVoiceChangerType:(TXVoiceChangeType) changerType

设置人声的变声特效

通过该接口您可以设置人声的变声特效，具体特效请参考枚举定义TXVoiceChangeType。

注意

设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。

◆ setVoiceEarMonitorVolume:()

- (void) setVoiceEarMonitorVolume:(NSInteger) volume

设置耳返音量

通过该接口您可以设置耳返特效中声音的音量大小。

参数

volume音量大小，取值范围为0 - 100，默认值：100。

注意

如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。

◆ setVoicePitch:()

- (void) setVoicePitch:(double) pitch

设置语音音调

该接口可以设置语音音调，用于实现变调不变速的目的。

参数

pitch音调，取值范围为-1.0f~1.0f，默认值：0.0f。

◆ setVoiceReverbType:()

- (void) setVoiceReverbType:(TXVoiceReverbType) reverbType

设置人声的混响效果

通过该接口您可以设置人声的混响效果，具体特效请参考枚举定义TXVoiceReverbType。

注意

设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。

◆ setVoiceVolume:()

- (void) setVoiceVolume:(NSInteger) volume

设置语音音量

该接口可以设置语音音量的大小，一般配合音乐音量的设置接口 setAllMusicVolume 协同使用，用于调谐语音和音乐在混音前各自的音量占比。

参数

volume音量大小，取值范围为0 - 100，默认值：100。

注意

如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。

◆ startPlayMusic:onStart:onProgress:onComplete:()

- (void) startPlayMusic:(TXAudioMusicParam *) musicParam
onStart:(TXAudioMusicStartBlock _Nullable) startBlock
onProgress:(TXAudioMusicProgressBlock _Nullable) progressBlock
onComplete:(TXAudioMusicCompleteBlock _Nullable) completeBlock 

开始播放背景音乐

每个音乐都需要您指定具体的 ID，您可以通过该 ID 对音乐的开始、停止、音量等进行设置。

注意

  1. 如果要多次播放同一首背景音乐，请不要每次播放都分配一个新的 ID，我们推荐使用相同的 ID。
  2. 若您希望同时播放多首不同的音乐，请为不同的音乐分配不同的 ID 进行播放。
  3. 如果使用同一个 ID 播放不同音乐，SDK 会先停止播放旧的音乐，再播放新的音乐。

参数

musicParam音乐参数
startBlock播放开始回调
progressBlock播放进度回调
completeBlock播放结束回调

◆ stopPlayMusic:()

- (void) stopPlayMusic:(int32_t) id

停止播放背景音乐

参数

id音乐 ID

类型定义说明

◆ TXAudioMusicCompleteBlock

typedef void(^ TXAudioMusicCompleteBlock) (NSInteger errCode)

背景音乐已经播放完毕

◆ TXAudioMusicProgressBlock

typedef void(^ TXAudioMusicProgressBlock) (NSInteger progressMs, NSInteger durationMs)

背景音乐的播放进度

◆ TXAudioMusicStartBlock

typedef void(^ TXAudioMusicStartBlock) (NSInteger errCode)

背景音乐开始播放

枚举类型说明

◆ TXVoiceChangeType

enum TXVoiceChangeType : NSInteger

变声特效

变声特效可以作用于人声之上，通过声学算法对人声进行二次处理，以获得与原始声音所不同的音色，目前支持如下几种变声特效： 0：关闭；1：熊孩子；2：萝莉；3：大叔；4：重金属；5：感冒；6：外语腔；7：困兽；8：肥宅；9：强电流；10：重机械；11：空灵。

枚举值
TXVoiceChangeType_0 

disable

TXVoiceChangeType_1 

naughty kid

TXVoiceChangeType_2 

Lolita

TXVoiceChangeType_3 

uncle

TXVoiceChangeType_4 

heavy metal

TXVoiceChangeType_5 

catch cold

TXVoiceChangeType_6 

foreign accent

TXVoiceChangeType_7 

caged animal trapped beast

TXVoiceChangeType_8 

indoorsman

TXVoiceChangeType_9 

strong current

TXVoiceChangeType_10 

heavy machinery

TXVoiceChangeType_11 

intangible

◆ TXVoiceReverbType

enum TXVoiceReverbType : NSInteger

混响特效

混响特效可以作用于人声之上，通过声学算法对声音进行叠加处理，模拟出各种不同环境下的临场感受，目前支持如下几种混响效果： 0：关闭；1：KTV；2：小房间；3：大会堂；4：低沉；5：洪亮；6：金属声；7：磁性；8：空灵；9：录音棚；10：悠扬；11：留声机；12：自然。

枚举值
TXVoiceReverbType_0 

disable

TXVoiceReverbType_1 

KTV

TXVoiceReverbType_2 

small room

TXVoiceReverbType_3 

great hall

TXVoiceReverbType_4 

deep voice

TXVoiceReverbType_5 

loud voice

TXVoiceReverbType_6 

metallic sound

TXVoiceReverbType_7 

magnetic sound

TXVoiceReverbType_8 

ethereal

TXVoiceReverbType_9 

studio

TXVoiceReverbType_10 

melodious

TXVoiceReverbType_11 

phonograph

TXVoiceReverbType_12 

nature

szqcloud
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值