pma
簡述
圍繞使用 FiveM/RedM 內部 Mumble 服務器而設計的語音系統
一個 tokovoip 替代品
- 收音機(目前每個玩家一個收音機頻道)
- 無線電麥克風點擊次數
- 來電
- 說話時的面部動畫
- 電話揚聲器模式切換
- 聽到附近的電話
- 用戶界面
- 語音聊天和麥克風禁用警告消息
- 3D Proximity 基礎音頻
- 語音通道的網格系統
注意
這個腳本與其他語音系統不兼容(duh),這意味著如果你有 vMenus 語音聊天,你將不得不禁用它
請不要覆蓋 NetworkSetTalkerProximity, MumbleSetTalkerProximity, MumbleSetAudioInputDistance, MumbleSetAudioOutputDistance 或 NetworkSetVoiceActive 在您的任何其他腳本中,因為在某些情況下它會破壞 pma-voice
配置
注意:僅使用其中一個音頻選項(不要同時啟用 3d 音頻和原生音頻),還建議始終使用 voice_useSendingRangeOnly
如果要更改值,則只需要添加 convar
這裡的所有配置都是使用setr [voice_configOption] [boolean]
| 控制變量 | 默認 | 描述 | 參數 |
|---|---|---|---|
| voice_useNativeAudio | false | 這不適用於 RedM使用遊戲原生音頻,將添加 3d 聲音、迴聲、混響等。子混音需要 | 布爾值 |
| voice_use2dAudio | false | 使用 2d 音頻,無論他們在哪裡,都會產生相同音量的聲音,直到他們離開附近 | 布爾值 |
| voice_use3dAudio | false | 使用 3d 音頻 | 布爾值 |
| voice_useSendingRangeOnly | false | 只允許您聽到您聽到/發送範圍內的人,防止人們連接到您的喃喃自語服務器和拖釣 | 布爾值 |
配置
請注意:任何鍵綁定更改只會影響新玩家,如果您想更改鍵綁定,請轉到 Key Bindings -> FiveM -> 在“pma-voice”下查找鍵綁定
所有配置都是通過 ConVars 完成的,以簡化流程
整數的使用就像布爾值一樣,0 為否,1 為是
這裡的所有配置都是 使用 setr [voice_configOption] [int] 或 setr [voice_configOption] "[string]"
注意:如果 convar 默認為 1 (true),除非您想禁用它,否則您無需再次設置它
常規語音設置
| 控制變量 | 默認 | 描述 | 參數 |
|---|---|---|---|
| voice_enableUi | 1 | 啟用內置用戶界面 | 整數 |
| voice_enableProximityCycle | 1 | 啟用 F11 接近鍵,如果禁用的玩家卡在第一個接近鍵上 | 整數 |
| voice_defaultCycle | F11 | 循環玩家接近度的默認鍵。您可以在 Cfx 文檔中找到有效密鑰的列表 | 字串 |
| voice_defaultRadioVolume | 30 | 設置收音機的默認音量 (必須在 1 到 100 之間)注意:只有新加入的玩家才會有新的值,已經加入的玩家不會。 | 浮點型 |
| voice_defaultCallVolume | 60 | 設置呼叫的默認音量 (必須在 1 到 100 之間)注意:只有新加入的玩家才會有新的值,已經加入的玩家不會。 | 浮點型 |
| voice_defaultVoiceMode | 2 | 玩家加入服務器時的默認鄰近語音值 (語音模式;1:耳語,2:普通,3:喊叫) | 整數 |
通話和廣播
| 控制變量 | 默認 | 描述 | 參數 |
|---|---|---|---|
| voice_enableRadios | 1 | 啟用無線電子模塊 | 整數 |
| voice_enableCalls | 1 | 啟用呼叫子模塊 | 整數 |
| voice_enableSubmix | 1 | 啟用子混音,將收音機/呼叫風格的子混音添加到他們的聲音注意:子混音需要原生音頻 | 整數 |
| voice_enableRadioAnim | 0 | 在收音機上講話時啟用(抓肩麥克風)動畫。 | 整數 |
| voice_defaultRadio | LMENU | 使用收音機的默認鍵。您可以在 FiveM 文檔中找到有效密鑰的列表 | 字串 |
同步
| 控制變量 | 默認 | 描述 | 參數 |
|---|---|---|---|
| 語音刷新率 | 200 | UI/Proximity 的刷新頻率 | 整數 |
外部服務器和雜項
| 控制變量 | 默認 | 描述 | 參數 |
|---|---|---|---|
| voice_allowSetIntent | 1 | 是否允許玩家設置他們的音頻意圖(你可以在這裡查看更多) | 整數 |
| voice_externalAddress | 沒有任何 | 用於連接到 mumble 服務器的外部地址 | 字串 |
| voice_externalPort | 0 | 要使用的外部端口 | 整數 |
| voice_debugMode | 0 | 1 用於基本日誌,4 用於詳細日誌 | 整數 |
| voice_externalDisallowJoin | 0 | 禁止玩家加入服務器,僅當您使用 FXServer 作為外部 Mumble 服務器時才應使用 | 整數 |
| voice_hideEndpoints | 1 | 在日誌中隱藏含糊地址注意:您應該只關心為外部服務器隱藏此地址 | 整數 |
管理
pma-voice 帶有一個內置的 /muteply (tgtPly) (duration) 命令,為了讓您的員工使用它,您必須讓他們成為管理員!
例子: add_ace group.superadmin command.muteply allow
這只會允許超級管理員組將玩家靜音
出口
客戶端
設定
| 出口 | 描述 | 參數 |
|---|---|---|
| setVoiceProperty | 設置配置選項 | 字符串,任何 |
| setRadioChannel | 設置廣播頻道 | 整數 |
| setCallChannel | 設置通話通道 | 整數 |
| setRadioVolume | 設置播放器的收音機音量 | 整數 |
| setCallVolume | 設置播放器的通話音量 | 整數 |
| addPlayerToRadio | 設置廣播頻道 | 整數 |
| addPlayerToCall | 設置通話通道 | 整數 |
| removePlayerFromRadio | 從收音機中刪除播放器 | |
| removePlayerFromCall | 從通話中移除玩家 |
切換
| 出口 | 描述 | 參數 |
|---|---|---|
| 切換靜音播放器 | 切換為本地客戶端靜音的選定播放器 | 整數 |
受 mumble-voip / toko-voip 支持
| 出口 | 描述 | 參數 |
|---|---|---|
| SetMumbleProperty | 設置配置選項 | 字符串,任何 |
| SetTokoProperty | 設置配置選項 | 字符串,任何 |
| SetRadioChannel | 設置廣播頻道 | 整數 |
| SetCallChannel | 設置通話通道 | 整數 |
檢查
大多數二傳手是通過玩家狀態完成的,而一小部分
| State Bag | 描述 | 返回類型 |
|---|---|---|
| proximity | 返回包含模式索引、距離和模式名稱的表 | table |
| radioChannel | 返回玩家當前的廣播頻道,或 0 表示無 | 整數 |
| callChannel | 返回玩家當前通話頻道,或 0 表示無 | 整數 |
事件
這些是為第三方資源整合而設計的事件。這些僅發送給當前客戶端
| 事件 | 描述 | 事件參數 |
|---|---|---|
| pma-voice:settingsCallback | 發出時,它將返回當前 pma-voice 設置 | cb(語音設置) |
| pma-voice:radioActive | 當無線電被激活/停用時觸發 | 布爾值 |
| pma-voice:setTalkingMode | 使用語音模式 ID 在接近模式更改時觸發 | 整數 |
服務器
設定
| 出口 | 描述 | 參數 |
|---|---|---|
| setPlayerRadio | 設置播放器廣播頻道 | 整數,整數 |
| setPlayerCall | 設置玩家通話通道 | 整數,整數 |
| addChannelCheck | 向播放器廣播頻道添加頻道檢查 | 整數,函數 |
吸氣劑
State Bags
您可以使用以下方式訪問狀態 Player(source).state['state bag here']
| State Bags | 描述 | 返回類型 |
|---|---|---|
| proximity | 返回包含模式索引、距離和模式名稱的表 | 桌子 |
| radioChannel | 返回玩家當前的廣播頻道,或 0 表示無 | 整數 |
| callChannel | 返回玩家當前通話頻道,或 0 表示無 | 整數 |
| voiceIntent | 返回玩家當前的語音意圖,'語音' 或 '音樂' | 字串 |
exports
| 出口 | 描述 | 參數 |
|---|---|---|
| getPlayersInRadioChannel | 獲取廣播頻道中的當前播放器 | 整數 |