Sintaxe
Parâmetros
localUser PartyLocalUser*
O usuário local do novo controle de chat local.
languageCode PartyStringopcional O idioma opcional a ser usado.
asyncIdentifier void*opcional Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.
localChatControl PartyLocalChatControl**optional, library-allocated output O controle de chat local de saída opcional.
Valor retornado
PartyErrorc_partyErrorSuccess se a operação assíncrona para criar um controle de chat tiver sido iniciada ou um código de erro caso contrário. Se este método falhar, nenhuma alteração de estado relacionada será gerada. A forma legível do código de erro pode ser obtida por meio de PartyManager::GetErrorMessage().
Comentários
Se este método retornar êxito, um PartyCreateChatControlCompletedStateChange será gerado para fornecer o resultado da operação assíncrona. Se a operação assíncrona tiver êxito, um PartyChatControlCreatedStateChange será gerado. Se a operação falhar, um PartyChatControlDestroyedStateChange será gerado. Este método por si só não torna o controle de chat visível para nenhum dispositivo remoto. Para anunciar este controle de chat aos dispositivos remotos, o título deve chamar PartyNetwork::ConnectChatControl().Em caso de retorno bem-sucedido, este método invalida a memória de qualquer matriz retornada anteriormente por PartyManager::GetChatControls() ou PartyDevice::GetChatControls() para o dispositivo local, pois adiciona de forma síncrona o novo controle de chat às matrizes. PartyManager::StartProcessingStateChanges() também invalida a memória dessas matrizes. O objeto
localChatControl retornado será válido até que um PartyChatControlDestroyedStateChange tenha sido gerado e todas as alterações de estado que fazem referência ao objeto tenham sido devolvidas a PartyManager::FinishProcessingStateChanges(). O idioma associado a este controle de chat pode, opcionalmente, ser especificado por meio do parâmetro
languageCode. Se nenhum idioma for especificado, será usado o padrão do usuário, conforme determinado pela plataforma. O idioma é usado como o idioma falado associado a este controle de chat para a transcrição e como o idioma de destino das traduções recebidas. Se o código de idioma especificado for en-US, por exemplo, o áudio de entrada deste controle de chat será tratado como o idioma inglês (Estados Unidos) e transcrito como tal. Se a tradução estiver habilitada por meio de PartyLocalChatControl::SetTranscriptionOptions() ou PartyLocalChatControl::SetTextChatOptions(), as transcrições de chat de voz e/ou o chat de texto recebidos serão traduzidos para inglês (Estados Unidos). O código de idioma deve estar no formato BCP 47; os códigos de idioma com suporte estão enumerados em Suporte a idiomas. Especificar um código de idioma sem suporte ou inválido não fará com que este método falhe, mas resultará em falha na geração de transcrições associadas a este controle de chat. O código de idioma usado com este método pode ser consultado por meio de PartyLocalChatControl::GetLanguage().
Requisitos
Cabeçalho: Party.hConfira também
PartyLocalDevicePartyCreateChatControlCompletedStateChange
PartyChatControlCreatedStateChange
PartyChatControlDestroyedStateChange
PartyManager::GetChatControls
PartyDevice::GetChatControls
PartyNetwork::ConnectChatControl
PartyLocalChatControl::GetLanguage
PartyLocalChatControl::SetTranscriptionOptions
PartyLocalChatControl::SetTranscriptionOptions