API et exports PMMS

But : piloter PMMS depuis vos propres ressources. Où : dans le code de vos ressources, démarrées après pmms.

Handles

Chaque lecteur actif est identifié par un handle :

• entité réseau : son identifiant réseau (NetworkGetNetworkIdFromEntity) ;
• entité locale ou position : un hash calculé à partir des coordonnées arrondies au dixième.

Les exports de démarrage renvoient ce handle ; gardez-le pour stop, pause, lock… pmms_ctl list (console serveur) affiche les handles actifs.

Exports serveur

Les exports serveur ne vérifient aucune permission et ne sont pas soumis à Config.oneMediaPerPlayer. Chaque démarrage par export est envoyé aux logs Discord comme « Lancement serveur/export ». stop, pause, lock, unlock, mute et unmute supposent un handle actif : vérifiez-le avec getMediaPlayerInfo avant l’appel.

getAllMediaPlayers et getMediaPlayerInfo renvoient les tables utilisées par le serveur : lisez-les sans les modifier.

Options de lecture

Table options des exports de démarrage, des presets et des lecteurs par défaut :

Exemple : radio d’un véhicule

Côté serveur, dans votre ressource (mon_garage est un exemple) :

RegisterNetEvent('mon_garage:radio', function(netId, url)
    local src = source
    if not IsPlayerAceAllowed(src, 'pmms.interact') then
        return
    end

    local entity = NetworkGetEntityFromNetworkId(netId)
    if entity == 0 or #(GetEntityCoords(GetPlayerPed(src)) - GetEntityCoords(entity)) > 5.0 then
        return
    end

    local current = exports.pmms:getMediaPlayerInfo(netId)
    if current then
        exports.pmms:stop(netId)
    end

    exports.pmms:startByNetworkId(netId, {
        url = url,
        title = 'Radio',
        volume = 70,
        filter = false,
        range = 25
    })
end)

Résultat : la radio du véhicule joue l’URL pour tous les joueurs à moins de 25 m. Le contrôle de permission et de distance est fait par votre événement, puisque l’export n’en fait aucun. Validez aussi url selon vos règles.

Exemple : enceinte personnelle

Côté client :

local speaker

RegisterCommand('enceinte', function()
    if speaker then
        exports.pmms:deleteMediaPlayer(speaker)
        speaker = nil
        return
    end

    local ped = PlayerPedId()
    speaker = exports.pmms:createMediaPlayer({
        model = `prop_boombox_01`,
        position = GetOffsetFromEntityInWorldCoords(ped, 0.0, 0.8, -0.95),
        rotation = vector3(0.0, 0.0, GetEntityHeading(ped))
    })
end)

Résultat : /enceinte pose une enceinte devant le joueur ; elle apparaît dans son panneau même sans pmms.anyEntity, et disparaît à l’arrêt de pmms ou au second appel.

Exports client

Événements

Les événements pmms:* servent à la communication interne entre client, serveur et interface. Ils ne constituent pas une API publique : utilisez les exports.

Erreurs fréquentes

• « No such export » : pmms n’est pas démarré, ou votre ressource démarre avant lui.
• Erreur Lua sur stop ou lock : le handle ne correspond à aucun lecteur actif.
• Média qui ne s’arrête jamais : duration absent, le média est traité comme un direct ; la boucle et la file d’attente ne fonctionnent pas non plus.
• Effet radio inattendu : filter absent dans les options (voir Dépannage).