Sintaxe
Parâmetros
targetChatControl PartyChatControl*
O controle de chat de destino.
chatPermissionOptions PartyChatPermissionOptions
As opções de permissão de chat.
Valor retornado
PartyErrorc_partyErrorSuccess se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de PartyManager::GetErrorMessage().
Comentários
As permissões de chat permitem controlar a comunicação por voz recebida e enviada, bem como a comunicação por texto recebida, entre qualquer par de controles de chat. As permissões de chat devem ser configuradas para refletir seu cenário de destino. Por exemplo, se o controle de chat de destino for membro da mesma equipe, você provavelmente permitirá o áudio nas duas direções. Se o controle de chat de destino for membro de uma equipe adversária, você provavelmente não permitirá o áudio em nenhuma direção. Independentemente da equipe, você pode permitir o recebimento de texto.O controle de chat de destino deve ser remoto. A permissão padrão é PartyChatPermissionOptions::None.
Esta configuração é apenas local. Se um controle de chat local estiver configurado para enviar áudio a um controle de chat remoto, nenhum áudio será enviado ao controle de chat remoto, a menos que o controle de chat remoto também tenha sido configurado para receber áudio do controle de chat local na instância da biblioteca dele. Da mesma forma, se um controle de chat local estiver configurado para receber áudio de um controle de chat remoto, nenhum áudio será recebido do controle de chat remoto, a menos que o controle de chat remoto também tenha sido configurado para enviar áudio ao controle de chat local na instância da biblioteca dele. Portanto, ambos os controles de chat devem concordar que a comunicação é permitida; um controle de chat não pode forçar outro a aceitar ou transmitir um chat indesejado.
Não há permissão associada ao envio de texto de chat porque cada chamada a SendText() exige uma lista explícita de controles de chat de destino. Incluir ou omitir um destino equivale a conceder ou negar a permissão de envio dessa mensagem de texto. O destino ainda precisa ter definido PartyChatPermissionOptions::ReceiveText na instância da biblioteca dele para que a mensagem seja de fato entregue.
A biblioteca do Party não impõe restrições da plataforma vinculadas à identidade do usuário, como uma configuração da plataforma que restringe o chat a “somente amigos”. As restrições da plataforma devem ser consideradas ao configurar as permissões de chat entre dois controles de chat.