Syntaxe
Paramètres
targetChatControl PartyChatControl*
Le contrôle de clavardage cible.
chatPermissionOptions PartyChatPermissionOptions
Les options d’autorisation de clavardage.
Valeur de retour
PartyErrorc_partyErrorSuccess si l’appel a réussi; sinon, un code d’erreur. La forme lisible du code d’erreur peut être obtenue au moyen de PartyManager::GetErrorMessage().
Remarques
Les autorisations de clavardage vous permettent de contrôler la communication vocale entrante et sortante, ainsi que la communication textuelle entrante, entre n’importe quelle paire de contrôles de clavardage. Les autorisations de clavardage doivent être configurées pour refléter votre scénario cible. Par exemple, si le contrôle de clavardage cible est membre de la même équipe, vous autoriserez probablement l’audio dans les deux sens. Si le contrôle de clavardage cible est membre d’une équipe adverse, vous n’autoriserez probablement l’audio dans aucun sens. Quelle que soit l’équipe, vous pouvez autoriser la réception de texte.Le contrôle de clavardage cible doit être distant. L’autorisation par défaut est PartyChatPermissionOptions::None.
Ce paramètre est uniquement local. Si un contrôle de clavardage local est configuré pour envoyer de l’audio à un contrôle de clavardage distant, aucun audio n’est envoyé au contrôle de clavardage distant, sauf si celui-ci a également été configuré pour recevoir l’audio du contrôle de clavardage local dans son instance de la bibliothèque. De même, si un contrôle de clavardage local est configuré pour recevoir de l’audio d’un contrôle de clavardage distant, aucun audio n’est reçu du contrôle de clavardage distant, sauf si celui-ci a également été configuré pour envoyer de l’audio au contrôle de clavardage local dans son instance de la bibliothèque. Par conséquent, les deux contrôles de clavardage doivent convenir que la communication est autorisée; un contrôle de clavardage ne peut pas forcer un autre à accepter ou à transmettre un clavardage non souhaité.
Aucune autorisation n’est associée à l’envoi de texte de clavardage, car chaque appel à SendText() nécessite une liste explicite de contrôles de clavardage cibles. Inclure ou omettre une cible équivaut à accorder ou à refuser l’autorisation d’envoi pour ce message texte. La cible doit tout de même avoir défini PartyChatPermissionOptions::ReceiveText dans son instance de la bibliothèque pour que le message soit effectivement remis.
La bibliothèque Party n’applique pas les restrictions de plateforme liées à l’identité de l’utilisateur, comme un paramètre de plateforme limitant le clavardage aux « amis uniquement ». Les restrictions de plateforme doivent être prises en compte lors de la configuration des autorisations de clavardage entre deux contrôles de clavardage.