0.0.1

resources/[standalone]/pma-voice/server/module/phone.lua

@@ -0,0 +1,76 @@
+--- removes a player from the call for everyone in the call.
+---@param source number the player to remove from the call
+---@param callChannel number the call channel to remove them from
+function removePlayerFromCall(source, callChannel)
+	logger.verbose('[call] Removed %s from call %s', source, callChannel)
+
+	callData[callChannel] = callData[callChannel] or {}
+	for player, _ in pairs(callData[callChannel]) do
+		TriggerClientEvent('pma-voice:removePlayerFromCall', player, source)
+	end
+	callData[callChannel][source] = nil
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	voiceData[source].call = 0
+end
+
+--- adds a player to a call
+---@param source number the player to add to the call
+---@param callChannel number the call channel to add them to
+function addPlayerToCall(source, callChannel)
+	logger.verbose('[call] Added %s to call %s', source, callChannel)
+	-- check if the channel exists, if it does set the varaible to it
+	-- if not create it (basically if not callData make callData)
+	callData[callChannel] = callData[callChannel] or {}
+	for player, _ in pairs(callData[callChannel]) do
+		-- don't need to send to the source because they're about to get sync'd!
+		if player ~= source then
+			TriggerClientEvent('pma-voice:addPlayerToCall', player, source)
+		end
+	end
+	callData[callChannel][source] = true
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	voiceData[source].call = callChannel
+	TriggerClientEvent('pma-voice:syncCallData', source, callData[callChannel])
+end
+
+--- set the players call channel
+---@param source number the player to set the call off
+---@param _callChannel number the channel to set the player to (or 0 to remove them from any call channel)
+function setPlayerCall(source, _callChannel)
+	if GetConvarInt('voice_enableCalls', 1) ~= 1 then return end
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	local isResource = GetInvokingResource()
+	local plyVoice = voiceData[source]
+	local callChannel = tonumber(_callChannel)
+	if not callChannel then
+		-- only full error if its sent from another server-side resource
+		if isResource then
+			error(("'callChannel' expected 'number', got: %s"):format(type(_callChannel)))
+		else
+			return logger.warn("%s sent a invalid call, 'callChannel' expected 'number', got: %s", source,
+				type(_callChannel))
+		end
+	end
+	if isResource then
+		-- got set in a export, need to update the client to tell them that their call
+		-- changed
+		TriggerClientEvent('pma-voice:clSetPlayerCall', source, callChannel)
+	end
+
+	Player(source).state.callChannel = callChannel
+
+	if callChannel ~= 0 and plyVoice.call == 0 then
+		addPlayerToCall(source, callChannel)
+	elseif callChannel == 0 then
+		removePlayerFromCall(source, plyVoice.call)
+	elseif plyVoice.call > 0 then
+		removePlayerFromCall(source, plyVoice.call)
+		addPlayerToCall(source, callChannel)
+	end
+end
+
+exports('setPlayerCall', setPlayerCall)
+
+RegisterNetEvent('pma-voice:setPlayerCall', function(callChannel)
+	setPlayerCall(source, callChannel)
+end)

resources/[standalone]/pma-voice/server/module/radio.lua

@@ -0,0 +1,193 @@
+
+local msgpack_pack_args = msgpack.pack_args
+
+local radioChecks = {}
+
+--- checks if the player can join the channel specified
+--- @param source number the source of the player
+--- @param radioChannel number the channel they're trying to join
+--- @return boolean if the user can join the channel
+function canJoinChannel(source, radioChannel)
+	if radioChecks[radioChannel] then
+		return radioChecks[radioChannel](source)
+	end
+	return true
+end
+
+--- adds a check to the channel, function is expected to return a boolean of true or false
+---@param channel number the channel to add a check to
+---@param cb function the function to execute the check on
+function addChannelCheck(channel, cb)
+	local channelType = type(channel)
+	local cbType = type(cb)
+	if channelType ~= "number" then
+		error(("'channel' expected 'number' got '%s'"):format(channelType))
+	end
+	if cbType ~= 'table' or not cb.__cfx_functionReference then
+		error(("'cb' expected 'function' got '%s'"):format(cbType))
+	end
+	radioChecks[channel] = cb
+	logger.info("%s added a check to channel %s", GetInvokingResource(), channel)
+end
+
+exports('addChannelCheck', addChannelCheck)
+
+--- removes any check for the channel
+---@param channel number the channel to add a check to
+function removeChannelCheck(channel)
+	local channelType = type(channel)
+	if channelType ~= "number" then
+		error(("'channel' expected 'number' got '%s'"):format(channelType))
+	end
+	radioChecks[channel] = nil
+	logger.info("%s removed check for channel %s", GetInvokingResource(), channel)
+end
+
+exports("removeChannelCheck", removeChannelCheck)
+
+local function radioNameGetter_orig(source)
+	return GetPlayerName(source)
+end
+local radioNameGetter = radioNameGetter_orig
+
+--- triggers an event for all of the players in the table while only doing msgpack
+--- serialization once
+local function triggerEventForRadioChannel(eventName, radioTbl, ...)
+		local payload = msgpack_pack_args(...)
+		for player, _ in pairs(radioTbl) do
+			TriggerClientEventInternal(eventName, player, payload, payload:len())
+		end
+end
+
+--- adds a check to the channel, function is expected to return a boolean of true or false
+---@param cb function the function to execute the check on
+function overrideRadioNameGetter(channel, cb)
+	local cbType = type(cb)
+	if cbType == 'table' and not cb.__cfx_functionReference then
+		error(("'cb' expected 'function' got '%s'"):format(cbType))
+	end
+	radioNameGetter = cb
+	logger.info("%s added a check to channel %s", GetInvokingResource(), channel)
+end
+
+exports('overrideRadioNameGetter', overrideRadioNameGetter)
+
+--- adds a player to the specified radion channel
+---@param source number the player to add to the channel
+---@param radioChannel number the channel to set them to
+---@return boolean wasAdded if the player was successfuly added to the radio channel, or if it failed.
+function addPlayerToRadio(source, radioChannel)
+	if not canJoinChannel(source, radioChannel) then
+		-- remove the player from the radio client side
+		TriggerClientEvent("pma-voice:radioChangeRejected", source)
+		TriggerClientEvent('pma-voice:removePlayerFromRadio', source, source)
+		return false
+	end
+	logger.verbose('[radio] Added %s to radio %s', source, radioChannel)
+
+	-- check if the channel exists, if it does set the varaible to it
+	-- if not create it (basically if not radiodata make radiodata)
+	radioData[radioChannel] = radioData[radioChannel] or {}
+	local plyName = radioNameGetter(source)
+	triggerEventForRadioChannel('pma-voice:addPlayerToRadio', radioData[radioChannel], source, plyName)
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	voiceData[source].radio = radioChannel
+	radioData[radioChannel][source] = false
+	TriggerClientEvent('pma-voice:syncRadioData', source, radioData[radioChannel],
+		GetConvarInt("voice_syncPlayerNames", 0) == 1 and plyName)
+	return true
+end
+
+--- removes a player from the specified channel
+---@param source number the player to remove
+---@param radioChannel number the current channel to remove them from
+function removePlayerFromRadio(source, radioChannel)
+	logger.verbose('[radio] Removed %s from radio %s', source, radioChannel)
+	radioData[radioChannel] = radioData[radioChannel] or {}
+	triggerEventForRadioChannel('pma-voice:removePlayerFromRadio', radioData[radioChannel], source)
+	radioData[radioChannel][source] = nil
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	voiceData[source].radio = 0
+end
+
+-- TODO: Implement this in a way that allows players to be on multiple channels
+--- sets the players current radio channel
+---@param source number the player to set the channel of
+---@param _radioChannel number the radio channel to set them to (or 0 to remove them from radios)
+function setPlayerRadio(source, _radioChannel)
+	if GetConvarInt('voice_enableRadios', 1) ~= 1 then return end
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	local isResource = GetInvokingResource()
+	local plyVoice = voiceData[source]
+	local radioChannel = tonumber(_radioChannel)
+	if not radioChannel then
+		-- only full error if its sent from another server-side resource
+		if isResource then
+			error(("'radioChannel' expected 'number', got: %s"):format(type(_radioChannel)))
+		else
+			return logger.warn("%s sent a invalid radio, 'radioChannel' expected 'number', got: %s", source,
+				type(_radioChannel))
+		end
+	end
+	if isResource then
+		-- got set in a export, need to update the client to tell them that their radio
+		-- changed
+		TriggerClientEvent('pma-voice:clSetPlayerRadio', source, radioChannel)
+	end
+	if radioChannel ~= 0 then
+		if plyVoice.radio > 0 then
+			removePlayerFromRadio(source, plyVoice.radio)
+		end
+		local wasAdded = addPlayerToRadio(source, radioChannel)
+		Player(source).state.radioChannel = wasAdded and radioChannel or 0
+	elseif radioChannel == 0 then
+		removePlayerFromRadio(source, plyVoice.radio)
+		Player(source).state.radioChannel = 0
+	end
+end
+
+exports('setPlayerRadio', setPlayerRadio)
+
+RegisterNetEvent('pma-voice:setPlayerRadio', function(radioChannel)
+	setPlayerRadio(source, radioChannel)
+end)
+
+--- syncs the player talking across all radio members
+---@param talking boolean sets if the palyer is talking.
+function setTalkingOnRadio(talking)
+	if GetConvarInt('voice_enableRadios', 1) ~= 1 then return end
+	voiceData[source] = voiceData[source] or defaultTable(source)
+	local plyVoice = voiceData[source]
+	local radioTbl = radioData[plyVoice.radio]
+	if radioTbl then
+		radioTbl[source] = talking
+		logger.verbose('[radio] Set %s to talking: %s on radio %s', source, talking, plyVoice.radio)
+		triggerEventForRadioChannel('pma-voice:setTalkingOnRadio', radioTbl, source, talking)
+	end
+end
+
+RegisterNetEvent('pma-voice:setTalkingOnRadio', setTalkingOnRadio)
+
+AddEventHandler("onResourceStop", function(resource)
+	for channel, cfxFunctionRef in pairs(radioChecks) do
+		local functionRef = cfxFunctionRef.__cfx_functionReference
+		local functionResource = string.match(functionRef, resource)
+		if functionResource then
+			radioChecks[channel] = nil
+			logger.warn('Channel %s had its radio check removed because the resource that gave the checks stopped',
+				channel)
+		end
+	end
+
+	if type(radioNameGetter) == "table" then
+		local radioRef = radioNameGetter.__cfx_functionReference
+		if radioRef then
+			local isResource = string.match(radioRef, resource)
+			if isResource then
+				radioNameGetter = radioNameGetter_orig
+				logger.warn(
+					'Radio name getter is resetting to default because the resource that gave the cb got turned off')
+			end
+		end
+	end
+end)