Accueil › Documentation › Exports · origen_radio

Exports · origen_radio

Tous les exports sont enregistrés sous le nom de ressource origen_radio.

Exports côté serveur

FW_GetPlayer(source, ignoreMetadata) → table | nil

Renvoie un objet joueur normalisé pour l’ID serveur donné. Fonctionne avec QBCore comme avec ESX : la structure renvoyée est toujours compatible QBCore.

lua
local Player = exports['origen_radio']:FW_GetPlayer(source)
if Player then
    print(Player.PlayerData.citizenid)
end
Paramètre Type Description
source number ID serveur du joueur
ignoreMetadata boolean Si true, les métadonnées ne sont pas chargées (plus rapide)

FW_GetPlayerFromCitizenid(citizenid, ignoreMetadata) → table | nil

Renvoie un objet joueur normalisé recherché par citizenid. Prend en charge les joueurs en ligne et hors ligne.

lua
local Player = exports['origen_radio']:FW_GetPlayerFromCitizenid("ABC12345")
Paramètre Type Description
citizenid string Le citizenid du joueur
ignoreMetadata boolean Si true, les métadonnées ne sont pas chargées

IsPlayerTalking(player) → boolean

Renvoie true si le joueur donné est en train d’émettre sur une fréquence radio.

lua
local talking = exports['origen_radio']:IsPlayerTalking(source)
Paramètre Type Description
player number ID serveur du joueur

GetPlayersInFrec(frec) → table

Renvoie une table contenant les ID serveur de tous les joueurs actuellement sur la fréquence donnée. Renvoie une table vide si la fréquence est "entrada" ou n’a aucun joueur actif.

lua
local players = exports['origen_radio']:GetPlayersInFrec("100.5")
for playerId, _ in pairs(players) do
    print(playerId, "is on frequency 100.5")
end
Paramètre Type Description
frec string Chaîne d’adresse de la fréquence (p. ex. "100.5")

GetPlayersReady(group) → table

Renvoie une table contenant les ID serveur des joueurs marqués comme prêts dans le groupe multifréquence donné.

lua
local ready = exports['origen_radio']:GetPlayersReady("police-ABC123")
Paramètre Type Description
group string Nom complet du groupe, suffixe du propriétaire inclus (p. ex. "police-citizenid")

GetMultiFrecs(group) → table

Renvoie la carte multifréquence complète du groupe donné, indexée par nom de fréquence puis par ID serveur du joueur.

lua
local freqs = exports['origen_radio']:GetMultiFrecs("police-ABC123")
for freqName, players in pairs(freqs) do
    print(freqName, players)
end
Paramètre Type Description
group string Nom complet du groupe (p. ex. "police-citizenid")

Exports côté client

OpenRadio()

Ouvre l’interface NUI de la radio. Respecte les vérifications de CanOpenRadio() et de Config.NeedRadioItem.

lua
exports['origen_radio']:OpenRadio()

Toggle(value)

Active ou désactive la radio. Si value vaut nil, l’état actuel est inversé.

lua
exports['origen_radio']:Toggle(true)   -- enable
exports['origen_radio']:Toggle(false)  -- disable
exports['origen_radio']:Toggle()       -- flip
Paramètre Type Description
value boolean | nil true pour activer, false pour désactiver, nil pour inverser

SetFreq(value)

Définit la fréquence simplex active. Utilise 0 pour quitter la fréquence actuelle.

lua
exports['origen_radio']:SetFreq(100.5)
exports['origen_radio']:SetFreq(0)  -- leave frequency
Paramètre Type Description
value number Numéro de fréquence, ou 0 pour se déconnecter

SetTargets(value)

Remplace la table actuelle des cibles simplex par celle fournie.

lua
exports['origen_radio']:SetTargets({ [3] = true, [7] = true })

AddPlayerTarget(id)

Ajoute un joueur à la liste actuelle des cibles simplex.

lua
exports['origen_radio']:AddPlayerTarget(playerId)

RemovePlayerTarget(id)

Retire un joueur de la liste actuelle des cibles simplex.

lua
exports['origen_radio']:RemovePlayerTarget(playerId)

SetMultiFrec(group, value, reason)

Définit le slot multifréquence actif au sein d’un groupe. Utilise "none" comme value pour te déconnecter du slot actuel.

lua
exports['origen_radio']:SetMultiFrec("police-ABC123", "alpha", nil)
exports['origen_radio']:SetMultiFrec("police-ABC123", "none", nil) -- disconnect
Paramètre Type Description
group string Nom du groupe
value string Nom du slot de fréquence, ou "none" pour se déconnecter
reason string | nil Motif facultatif (p. ex. "moved")

SetMultiFrecTargets(value)

Remplace toute la carte des cibles multifréquence.

lua
exports['origen_radio']:SetMultiFrecTargets(newTargets)

AddPlayerMultiFrec(id, frec, data)

Ajoute un joueur à un slot précis de la carte des cibles multifréquence.

lua
exports['origen_radio']:AddPlayerMultiFrec(playerId, "alpha", { name = "John Doe", muted = false })

RemovePlayerMultiFrec(id, frec)

Retire un joueur d’un slot multifréquence précis, ou de n’importe quel slot si frec vaut nil.

lua
exports['origen_radio']:RemovePlayerMultiFrec(playerId, "alpha")
exports['origen_radio']:RemovePlayerMultiFrec(playerId) -- search all slots

MovePlayerMultiFrec(id, group, frec)

Déplace un joueur de son slot actuel vers un autre au sein du même groupe, en se synchronisant avec le serveur.

lua
exports['origen_radio']:MovePlayerMultiFrec(playerId, "police-ABC123", "bravo")

SetMuted(id, value)

Définit l’état muet d’un joueur dans la carte des cibles multifréquence.

lua
exports['origen_radio']:SetMuted(playerId, true)

SetAnim(value)

Définit l’animation radio active par index (à partir de 1, selon RadioConfig.Anims).

lua
exports['origen_radio']:SetAnim(2) -- use second animation preset

ToggleClicks(value)

Active ou désactive le son de clic de la radio au début et à la fin de l’émission.

lua
exports['origen_radio']:ToggleClicks(false) -- disable click sounds

GetMultiFrec() → string

Renvoie le nom du slot de fréquence sur lequel se trouve le joueur local dans son groupe multifréquence. Renvoie "none" s’il n’est connecté à aucun slot.

lua
local slot = exports['origen_radio']:GetMultiFrec()

IsTalking() → boolean

Renvoie true si le joueur local est en train d’émettre sur n’importe quelle fréquence radio.

lua
if exports['origen_radio']:IsTalking() then
    -- player is on air
end

IsPlayerTalking(source) → boolean

Bridge côté client qui interroge le serveur et renvoie si le joueur donné est en train d’émettre. Attend que le serveur réponde.

lua
local talking = exports['origen_radio']:IsPlayerTalking(targetServerId)

GetPlayersInFrec(frec) → table

Bridge côté client qui interroge le serveur pour obtenir tous les joueurs d’une fréquence donnée. Attend que le serveur réponde.

lua
local players = exports['origen_radio']:GetPlayersInFrec("100.5")

Exports de raccourcis clavier (côté client)

Ces exports ne sont actifs que lorsque Config.BindSystem est à true.

AddKeyBind(key, action, name)

Enregistre un raccourci clavier qui déclenche un événement FiveM lorsqu’on appuie dessus.

lua
exports['origen_radio']:AddKeyBind("F5", "origen_radio:myEvent", "My Radio Bind")

SetDefaultBind(key, action)

Enregistre un raccourci clavier uniquement si l’action n’est pas déjà assignée à une touche.

lua
exports['origen_radio']:SetDefaultBind("F5", "origen_radio:myEvent")

RemoveKeyBind(key)

Supprime un raccourci clavier à partir du nom de la touche.

lua
exports['origen_radio']:RemoveKeyBind("F5")

GetKeyBinds() → table

Renvoie la carte complète des raccourcis du joueur local (key → action).

lua
local binds = exports['origen_radio']:GetKeyBinds()

RadioAddKeyBind(_type, key, action)

Enregistre un raccourci propre à la radio via RegisterKeyMapping. Nécessite Config.BindSystem = true.

lua
exports['origen_radio']:RadioAddKeyBind("keyboard", "F6", "origen_radio:myEvent")

RadioRemoveKeyBind(key)

Supprime un raccourci propre à la radio enregistré avec RadioAddKeyBind.

lua
exports['origen_radio']:RadioRemoveKeyBind("F6")