Mod · API pour moddeurs

Call System

Des appels vocaux privés entre joueurs, à distance illimitée, jusqu'à quatre voix par appel. Une API simple pour brancher une vraie téléphonie dans votre propre mod : vous décidez de l'interface, Call System s'occupe de la voix.

Voir sur le Workshop Lire l'API

4: voix par appel
∞: distance
PC · Xbox: testé en dédié
1: classe : CS_CallAPI

Galerie

Call System, en images.

Ce que les joueurs voient quand le téléphone de notre framework s'appuie sur Call System. Cliquez sur une image pour l'agrandir.

Vignette de Call System : deux joueurs en communication

Notifications du téléphone affichées en jeu

Comment ça marche

Une radio dans la poche,
sur une bande à part.

Le téléphone est un objet d'inventaire qui porte une radio réglée sur une bande de fréquences que les radios militaires n'utilisent jamais. Chaque joueur parle sur sa propre fréquence et écoute celle de ses correspondants : deux personnes peuvent parler en même temps sans se couper.

AJoueur ATéléphone · émet sur f.AOreillette · écoute f.B

voix de A · fréquence A

voix de B · fréquence B

BJoueur BTéléphone · émet sur f.BOreillette · écoute f.A

Rien à toucher pour parler

Pendant un appel, la voix de proximité du joueur part toute seule dans le téléphone au lieu d'être entendue autour de lui.

Une oreillette automatique

Une radio ne reçoit pas pendant qu'elle émet : le serveur donne une oreillette le temps de l'appel, puis la reprend.

Conférence et haut-parleur

On invite un troisième, un quatrième. En haut-parleur, les joueurs à moins de 3 m entendent l’appel et y sont entendus.

Des appels qui se rangent seuls

Sonnerie abandonnée après 30 s, appel terminé quand il ne reste qu'une personne, qu'elle meurt ou se déconnecte.

Pour les moddeurs

Tout passe par
une seule classe.

Call System ne fournit aucune interface : c'est votre mod qui décide quand on appelle, qui on appelle et ce qui s'affiche. Ajoutez la dépendance, et le moteur d'appels démarre tout seul avec le mode de jeu.

Ajouter la dépendanceDans le addon.gproj de votre mod.
Serveur dédiéAjouter aussi le mod dans la liste mods du config.json.
C'est toutChaque joueur reçoit un téléphone quand il apparaît. Désactivable si votre mod gère les téléphones lui-même.

GameProject {
 ID "MonMod"
 Dependencies {
  "58D0FB3206B6F859"   // ArmaReforger
  "6A5F303894B0F873"   // Call System
 }
}

// Fait sonner le téléphone de targetId
if (!CS_CallAPI.Call(callerId, targetId))
    Print("Appel impossible");

// Réagir aux appels
CS_CallAPI.GetOnRinging().Insert(OnRinging);
CS_CallAPI.GetOnAnswered().Insert(OnAnswered);

void OnRinging(int targetId, int callerId)
{
    // sonnerie, notification, vibration...
}

CS_CallAPI.GetOnLocalStateChanged().Insert(RefreshUI);

void RefreshUI()
{
    if (CS_CallAPI.GetLocalState() == CS_ECallState.INCOMING)
    {
        int callerId = CS_CallAPI.GetLocalCallerId();
        // "X vous appelle" + bouton :
        // CS_CallAPI.RequestAnswer();
    }
}

Actions · serveur

`Call(callerId, targetId)`	Fait sonner la cible. Déjà en ligne : l'invite en conférence.
`Answer(playerId)`	Décroche l'appel entrant.
`HangUp(playerId)`	Raccroche, refuse, ou quitte la conférence.
`SetSpeaker(playerId, state)`	Haut-parleur : 3 m autour entendent et sont entendus.
`GivePhone(playerId)`	Donne un téléphone au joueur s'il n'en a pas.
`SetAutoGivePhones(enabled)`	Distribution automatique à l'apparition.

Événements

`GetOnRinging()`	Un téléphone se met à sonner.
`GetOnAnswered()`	Quelqu'un a décroché.
`GetOnLeft()`	Quelqu'un a quitté l'appel, quelle qu'en soit la raison.
`GetOnCallEnded()`	L'appel est terminé pour tout le monde.
`GetOnSpeakerChanged()`	Le haut-parleur d'un joueur change.
`GetOnListenerChanged()`	Un joueur proche entre dans un haut-parleur ou en sort.

Déjà en jeu

La voix du téléphone
de notre framework.

Call System fait tourner les appels du téléphone de FrenchCore Framework : favoris, conférences, numéros d'urgence 17 et 18. Il y est intégré directement, pas besoin de charger les deux mods.

Voir le téléphone du framework