iOS直播/游戲怎麼利用特殊音效製造娛樂效果?

来源:https://www.cnblogs.com/zegodeveloper/archive/2022/05/18/16284636.html
-Advertisement-
Play Games

我們在直播中,為了增強真實感,烘托場景氛圍需要播放的簡短效果音。例如:掌聲、笑聲、禮物音效、提示音等。在游戲中,有時也需要播放子彈聲、碰撞打擊聲等。 ZegoExpress SDK 提供音效文件播放器,通過 ZegoAudioEffectPlayer 統一管理音效,支持音效播放(可以多音效重疊播放... ...


1 功能簡介

我們在直播中,為了增強真實感,烘托場景氛圍需要播放的簡短效果音。例如:掌聲、笑聲、禮物音效、提示音等。在游戲中,有時也需要播放子彈聲、碰撞打擊聲等。

ZegoExpress SDK 提供音效文件播放器,通過 ZegoAudioEffectPlayer 統一管理音效,支持音效播放(可以多音效重疊播放)、播放控制(如暫停播放、音量調節、設置播放進度)、預載入音效等功能。

2 支持格式

音效文件播放器支持播放 MP3、M4A、AAC、WAV 格式的本地音頻文件。

3 示例源碼下載

請參考 下載示例源碼 獲取源碼。

相關源碼請查看 “/ZegoExpressExample/Examples/AdvancedAudioProcessing/AudioEffectPlayer” 目錄下的文件。

4 前提條件

在實現音效文件播放器功能之前,請確保:

5 使用步驟

5.1 創建音效播放器

調用 ZegoExpressEnginecreateAudioEffectPlayer 方法創建音效播放器實例。

引擎當前只支持同時創建一個實例,超出後將返回 nil

@property (nonatomic, strong) ZegoAudioEffectPlayer *audioEffectPlayer;
self.audioEffectPlayer = [[ZegoExpressEngine sharedEngine] createAudioEffectPlayer];
if (!self.audioEffectPlayer) {
    NSLog(@"創建音效播放器失敗");
}

5.2 播放控制

5.2.1 (可選)為音效播放器設置事件回調

音效播放器事件回調設置

可以根據需要調用音效播放器的 setEventHandler 方法為播放器設置事件回調,用於監聽“音效播放狀態改變”等通知。

[self.audioEffectPlayer setEventHandler:self];
- (void)audioEffectPlayer:(ZegoAudioEffectPlayer *)audioEffectPlayer audioEffectID:(unsigned int)audioEffectID playStateUpdate:(ZegoAudioEffectPlayState)state errorCode:(int)errorCode {
    NSLog(@"Play state update. ID:%d, state:%lu, err:%d", audioEffectID, (unsigned long)state, (int)errorCode);
}

5.2.2 開始播放

調用 start 方法播放音效,目前僅支持同時播放 12 個,且只能為本地文件,不支持播放網路資源。 其中 “audioEffectID” 需要保持全局唯一。

  • 如果已通過 loadResource 方法預先載入了音效,則只需要傳入預載入時的 “audioEffectID”,“path”(音效資源的路徑)欄位傳空即可。
  • 若需要重覆播放可以通過 ZegoAudioEffectPlayConfig 中 “playCount” 配置重覆次數。如果設置為 “0”,則表示無限重覆播放,直到用戶手動調用 stop 停止。
// 此處示例獲取已存放於 App Bundle 內的 test.wav 資源
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"wav"];

ZegoAudioEffectPlayConfig *config = [[ZegoAudioEffectPlayConfig alloc] init];
config.playCount = 1; // 播放一次
config.isPublishOut = YES; // 播放混入推流中

// 使用 0 作為此次的 audioEffectID
[self.audioEffectPlayer start:0 path:filePath config:config];

5.2.3 暫停/恢復/停止播放

  1. 調用 pause 指定的音效,調用 pauseAll 方法則暫停所有正在播放的音效。
  2. 音效暫停播放後,調用 resume 方法可以恢復播放 “audioEffectID” 指定的音效,調用 resumeAll 方法則恢復所有已暫停音效。
  3. 調用 stop 指定的音效,調用 stopAll 方法則停止播放所有音效。
// 暫停 0 號 audioEffectID 資源的播放
[self.audioEffectPlayer pause:0];

// 恢復 0 號 audioEffectID 資源的播放
[self.audioEffectPlayer resume:0];

// 停止 0 號 audioEffectID 資源的播放
[self.audioEffectPlayer stop:0];

// 暫停所有資源的播放
[self.audioEffectPlayer pauseAll];

// 恢復所有資源的播放
[self.audioEffectPlayer resumeAll];

// 停止所有資源的播放
[self.audioEffectPlayer stopAll];

5.2.4 調節音量

  1. 調用 setVolume 方法可以設置 “audioEffectID” 指定的音效音量,取值範圍為 [0, 200],預設值為 “100”。
  2. 調用 setVolumeAll 方法則同時設置所有音效音量,取值範圍為 [0, 200],預設值為 “100”。
// 設置 0 號 audioEffectID 的音量為 100
[self.audioEffectPlayer setVolume:100 audioEffectID:0];

// 設置所有資源的音量為 100
[self.audioEffectPlayer setVolumeAll:100];

5.2.5 播放進度控制

  1. 調用 getTotalDuration 方法獲取單個音效的總時長。
  2. 調用 getCurrentProgress 方法獲取音效當前播放進度。
  3. 調用 seekTo 方法可以根據需要設置播放進度。
// 獲取 0 號 audioEffectID 的總時長
unsigned long long totalDuration = [self.audioEffectPlayer getTotalDuration:0];

// 獲取 0 號 audioEffectID 的當前播放進度
unsigned long long currentProgress = [self.audioEffectPlayer getCurrentProgress:0];

// 設置 0 號 audioEffectID 的播放進度為總進度的一半
[self.audioEffectPlayer seekTo:(unsigned long long)(totalDuration / 2) audioEffectID:0 callback:^(int errorCode) {
    NSLog(@"seekTo result: %d", errorCode);
}];

5.3 (可選)預載入資源

預載入資源

在頻繁播放相同音效場景中,SDK 為了優化重覆讀文件並解碼的性能,提供了預載入音效文件到記憶體中的功能。

調用 loadResource 方法載入音效資源,可通過 “callback” 參數來監聽載入的結果,顯示載入成功後方可播放。最多支持同時預載入 15 個本地音效文件(不支持網路資源),並且單個音效文件時長不能超過 30 s,否則載入會報錯。

當載入的音效使用完成後,可以調用 unloadResource 介面卸載,以釋放相關資源。否則 SDK 將在 ZegoAudioEffectPlayer 實例釋放時會自動卸載已載入的音效。

預載入為非必須操作,為了提高性能或者需要反覆播放某個特定的音效時推薦使用。

// 此處示例獲取已存放於 App Bundle 內的 test.wav 資源
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"wav"];

[self.audioEffectPlayer loadResource:filePath audioEffectID:0 callback:^(int errorCode) {
    NSLog(@"loadResource result, errorCode: %d", errorCode);
}];

5.4 銷毀媒體播放器

使用完音效播放器後,需要及時調用 destroyAudioEffectPlayer 方法銷毀,釋放該播放器占用的資源。

[[ZegoExpressEngine sharedEngine] destroyAudioEffectPlayer:self.audioEffectPlayer];

6 API 參考列表

方法 描述
createAudioEffectPlayer 創建音效播放器實例
setEventHandler 設置音效播放器回調
start 播放音效
pause 暫停播放單個音效
pauseAll 暫停播放所有音效
resume 恢復播放單個音效
resumeAll 恢復播放所有音效
stop 停止播放單個音效
stopAll 停止播放所有音效
setVolume 調節音效音量
setVolumeAll 調節所有音效音量
getTotalDuration 控制播放進度
getCurrentProgress 獲取當前播放進度
seekTo 設置指定的播放進度
loadResource 預載入資源
unloadResource 卸載資源
destroyAudioEffectPlayer 銷毀音效播放器實例

7 音效播放器與媒體播放器有什麼區別?

  • 媒體播放器主要用於播放視頻及較長的音樂,支持播放網路資源。同一時間最多支持創建 4 個播放器實例,一個實例只能播放一個音視頻。
  • 音效播放器主要用於播放時間較短的音效,不支持播放網路資源。同一時間只支持創建一個音效播放器實例,音效播放器支持多路音效併發播放,一個實例最多同時播放 12 個音效。

獲取更多支持

獲取本文的Demo、開發文檔、技術支持。
獲取SDK的商務活動、熱門產品。
註冊即構ZEGO開發者帳號,快速開始。

音視頻場景解決方案分享,更多詳情可搜索官網(https://zegoguanwang.datasink.sensorsdata.cn/t/pB)
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • SpringDataRedis的序列化的一些問題 RedisTemplate可以接收任意Object作為值寫入Redis,但是如果不實現設置序列化器的化預設是採用JDK序列化,序列化後的結果可讀性差並且記憶體占用空間大,如下圖。 自定義RedisTemplate的序列化方式 key和 hashKey採 ...
  • 導讀: 今天和大家分享京東零售OLAP平臺的建設和場景的實踐,主要包括四大部分: 管控面建設 優化技巧 典型業務 大促備戰 -- 01 管控面建設 1. 管控面介紹 管控面可以提供高可靠高效可持續運維保障、快速部署小時交付的能力,尤其是針對ClickHouse這種運維較弱但是性能很高的OLAP核心引 ...
  • 本文介紹如何使用 UPDATE 和 DELETE 語句處理表中的數據,還介紹了為什麼 WHERE 子句對 UPDATE 和 DELETE 語句很重要。 一、更新數據 更新(修改)表中的數據,可以使用 UPDATE 語句。有兩種使用 UPDATE 的方式: 更新表中的特定行; 更新表中的所有行。 下麵 ...
  • 本文介紹如何使用 SQL INSERT 語句將數據插入到表中,如何用 INSERT SELECT 從其他表中導入行,如何用 SELECT INTO 將行導出到一個新表。 一、數據插入 毫無疑問,SELECT 是最常用的 SQL 語句了。但是,還有其他 3 個常用的 SQL 語句需要學習。第一個就是 ...
  • i,大家好,我是大D。今天繼續瞭解下 HBase 是如何寫入數據的,然後再講解一下一個比較經典的面試題。 ...
  • 本文介紹如何利用 SQL UNION 操作符將多條 SELECT 語句組合成一個結果集。使用 UNION 可極大地簡化複雜的 WHERE 子句,簡化從多個表中檢索數據的工作。 一、組合查詢 多數 SQL 查詢只包含從一個或多個表中返回數據的單條 SELECT 語句。但是,SQL 也允許執行多個查詢( ...
  • 本文介紹自聯結(self-join)、自然聯結(natural join)和外聯結 (outer join),包括它們的含義和使用方法。介紹如何使用表別名,如何對被聯結的表使用聚集函數。 一、使用表別名 SQL 如何創建計算欄位 介紹瞭如何使用別名引用被檢索的表列。給列起別名的語法如下: SELEC ...
  • JSONOBJECT解析數據 若JSON格式數據如下所示: [{"id":"5","version":"5.5","name":"Clash of Clans"}, {"id":"6","version":"6.0","name":"Boom Beachx"}] 可以看到要解析的數據是一個JSON數 ...
一周排行
    -Advertisement-
    Play Games
  • 什麼是工廠模式 工廠模式是最常用的設計模式之一,屬於創建型模式。 有點: 解耦,可以把對象的創建和過程分開 減少代碼量,易於維護 什麼時候用? 當一個抽象類有多個實現的時候,需要多次實例化的時候,就要考慮使用工廠模式。 比如:登錄的抽象類ILoginBusiness,它有2個實現,一個用用戶名密碼登 ...
  • 這次iNeuOS升級主要升級圖形渲染引擎和增加豐富的圖元信息,可以很快的方案應用。總共增加41個通用和行業領域的圖元應用,增加2154個圖元信息,現在iNeuOS視圖建模功能模塊總共包括5894個行業圖元信息。現在完全支持製作高保真的工藝流程和大屏展示效果。 ...
  • 效果圖先附上: 首先 這是我是參考 教程:使用 SignalR 2 和 MVC 5 實時聊天 | Microsoft Docs 先附上教程: 在“添加新項 - SignalRChat”中,選擇 InstalledVisual> C#>WebSignalR>,然後選擇 SignalR Hub 類 (v ...
  • 一、前言 項目中之前涉及到胎兒心率圖曲線的繪製,最近項目中還需要添加心電曲線和血樣曲線的繪製功能。今天就來分享一下心電曲線的繪製方式; 二、正文 1、胎兒心率曲線的繪製是通過DrawingVisual來實現的,這裡的心電曲線我也是採用差不多相同的方式來實現的,只是兩者曲線的數據有所區別。心電圖的數據 ...
  • 安裝 Redis # 首先安裝依賴gcc, 後面需要使用make編譯redis yum install gcc -y # 進入 /usr/local/src 目錄, 把源碼下載到這裡 cd /usr/local/src # 下載 redis 7.0.2 的源碼,github被牆,可以使用國內的地址 ...
  • Redis 的定義? 百度百科: Redis(Remote Dictionary Server ),即遠程字典服務,是一個開源的使用ANSI C語言編寫、支持網路、可基於記憶體亦可持久化的日誌型、Key-Value資料庫,並提供多種語言的API。 中文官網: Redis是一個開源(BSD許可),記憶體存 ...
  • 事情的起因是收到了一位網友的請求,他的java課設需要設計實現迷宮相關的程式——如標題概括。 我這邊不方便透露相關信息,就只把任務要求寫出來。 演示視頻指路👉: 基於JavaFX圖形界面的迷宮程式演示_嗶哩嗶哩_bilibili 完整代碼鏈接🔎: 網盤:https://pan.baidu.com ...
  • Python中的字典 Python中的字典是另一種可變容器模型,且可存儲任意類型對象。鍵值使用冒號分割,你可以看成是一串json。 常用方法 獲取字典中的值 dict[key] 如果key不存在會報錯,建議使用dict.get(key),不存在返回None 修改和新建字典值 dict[key]=va ...
  • 迎面走來了你的面試官,身穿格子衫,挺著啤酒肚,髮際線嚴重後移的中年男子。 手拿泡著枸杞的保溫杯,胳膊夾著MacBook,MacBook上還貼著公司標語:“加班使我快樂”。 面試官: 看你簡歷上用過MySQL,問你幾個簡單的問題吧。什麼是聚簇索引和非聚簇索引? 這個問題難不住我啊。來之前我看一下一燈M ...
  • tunm二進位協議在python上的實現 tunm是一種對標JSON的二進位協議, 支持JSON的所有類型的動態組合 支持的數據類型 基本支持的類型 "u8", "i8", "u16", "i16", "u32", "i32", "u64", "i64", "varint", "float", "s ...