在 Cocos Creator 中實時遊戲語音
Cocos Creator 從 v2.0.9 版本開始,已經深度集成了聲網 Agora Voice SDK,廣大Cocos開發者可以一鍵開通、下載並整合聲網SDK到所需遊戲專案,並且能在 Creator 中通過統一JS APIs 來呼叫聲網 Agora iOS/Android/Web SDK 介面,在各平臺專案中快速實現實時語音功能。接下來我們來簡單講解一下。
在 Cocos Creator 中快速實現遊戲語音功能
在開始進行開發前,大家需要確保已經 安裝 Cocos Creator v2.0.9 ,因為以下操作將通過新版 Cococs Creator 來實現。同時,由於實時語音功能需要呼叫麥克風,所以大家還需要準備好 Android 或 iOS 真機 。為了保證第一次嘗試的效果,建議大家 關閉裝置端的 VPN 。
另外,如果你開發的是 Web 遊戲,那麼你的 Web 端瀏覽器還需要滿足一些特定要求,詳見聲網文件中心(docs.agora.io)。
首先在 Cocos Creator 中開啟你的遊戲專案。然後選中 面板
,在下拉選單中選擇 服務
。
在螢幕右側出現的 服務面板
中選擇 AgoraVoice
,並點選 啟用
。Cocos Creator 會自動下載和配置所有聲網服務依賴的資源。
至此,我們已經為 Cocos 遊戲添加了實時語音服務,接下來需要通過 JS 呼叫 Agora SDK 的介面來實現實際功能了。
JS 呼叫 Agora SDK 介面
首先我們需要先登入 Agora DashBoard ,在 專案
頁面中獲取自己的 App ID。然後將它填寫到下述程式碼中。
-
var agoraCreator = require("agoraCreator");
-
agoraCreator.createEngine("AGORA APP ID");
我們支援通過 JS 來呼叫 SDK 介面。例如,可以通過 .setChannelProfile(profile)
來設定頻道模式,如果你希望在遊戲中進行一對一或群聊,並且任何使用者都可以自由說話,那麼設定 profile
為通訊模式(profile 為 0)即可;如果是想實現類似團戰指揮的場景,那麼可以採用直播模式(profile 為 1),然後利用 setClientRole
來設定“指揮者”的角色。
另外,開發者還可以通過 JS 介面來設定本地語音音效均衡、本地音效混響、音效音量等功能。如果希望 瞭解詳細的介面功能,參考 Demo ,可以點選「閱讀原文」獲取。如果在開發過程中遇到疑問,可以在 RTC 開發者社群 (rtcdeveloper.com) 提問。
接下來,值得期待的新功能
大家已經可以通過最新版 Cocos Creator 使用以上服務,在遊戲中快速實現實時語音功能。接下來,我們還將在 Cocos Creator 中為開發者們提供實現遊戲視訊通話的功能,敬請期待。
目前,包括小米、完美世界、阿里遊戲、SuperEvil 等知名遊戲團隊,已經採用 Agora SDK 在遊戲中實現實時音視訊互動功能。