Syntaxe
Paramètres
localUser PartyLocalUser*
L’utilisateur local du nouveau contrôle de chat local.
languageCode PartyStringoptional La langue facultative à utiliser.
asyncIdentifier void*optional Une valeur de contexte facultative de la taille d’un pointeur, définie par l’application, qui peut être utilisée pour associer le changement d’état de fin à cet appel.
localChatControl PartyLocalChatControl**optional, library-allocated output Le contrôle de chat local de sortie facultatif.
Valeur renvoyée
PartyErrorc_partyErrorSuccess si l’opération asynchrone de création d’un contrôle de chat a commencé ; sinon, un code d’erreur. Si cette méthode échoue, aucun changement d’état associé n’est généré. La forme lisible du code d’erreur peut être obtenue via PartyManager::GetErrorMessage().
Remarques
Si cette méthode renvoie une réussite, un PartyCreateChatControlCompletedStateChange est généré pour fournir le résultat de l’opération asynchrone. Si l’opération asynchrone réussit, un PartyChatControlCreatedStateChange est généré. Si l’opération échoue, un PartyChatControlDestroyedStateChange est généré. Cette méthode elle-même ne rend pas le contrôle de chat visible pour les appareils distants. Pour annoncer ce contrôle de chat aux appareils distants, le titre doit appeler PartyNetwork::ConnectChatControl().En cas de retour réussi, cette méthode invalide la mémoire de tout tableau précédemment renvoyé par PartyManager::GetChatControls() ou PartyDevice::GetChatControls() pour l’appareil local, car elle ajoute de manière synchrone le nouveau contrôle de chat aux tableaux. PartyManager::StartProcessingStateChanges() invalide également la mémoire de ces tableaux. L’objet
localChatControl renvoyé reste valide jusqu’à ce qu’un PartyChatControlDestroyedStateChange ait été généré et que tous les changements d’état faisant référence à l’objet aient été renvoyés à PartyManager::FinishProcessingStateChanges(). La langue associée à ce contrôle de chat peut éventuellement être spécifiée via le paramètre
languageCode. Si aucune langue n’est spécifiée, la langue par défaut de l’utilisateur, déterminée par la plateforme, est utilisée. La langue est utilisée comme langue parlée associée à ce contrôle de chat pour la transcription, et comme langue cible pour les traductions entrantes. Si le code de langue spécifié est en-US, par exemple, l’audio d’entrée de ce contrôle de chat est traité comme de l’anglais (États-Unis) et transcrit comme tel. Si la traduction est activée via PartyLocalChatControl::SetTranscriptionOptions() ou PartyLocalChatControl::SetTextChatOptions(), les transcriptions du chat vocal et/ou le chat textuel entrants sont traduits en anglais (États-Unis). Le code de langue doit être au format BCP 47 ; les codes de langue pris en charge sont répertoriés dans Prise en charge des langues. La spécification d’un code de langue non pris en charge ou non valide ne fait pas échouer cette méthode, mais entraîne l’échec de la génération des transcriptions associées à ce contrôle de chat. Le code de langue utilisé avec cette méthode peut être interrogé via PartyLocalChatControl::GetLanguage().
Configuration requise
En-tête : Party.hVoir aussi
PartyLocalDevicePartyCreateChatControlCompletedStateChange
PartyChatControlCreatedStateChange
PartyChatControlDestroyedStateChange
PartyManager::GetChatControls
PartyDevice::GetChatControls
PartyNetwork::ConnectChatControl
PartyLocalChatControl::GetLanguage
PartyLocalChatControl::SetTranscriptionOptions
PartyLocalChatControl::SetTranscriptionOptions