Sintaxis
Parámetros
localUser PartyLocalUser*
El usuario local para el nuevo control de chat local.
languageCode PartyStringopcional El idioma opcional que se va a usar.
asyncIdentifier void*opcional Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización con esta llamada.
localChatControl PartyLocalChatControl**opcional, salida asignada por la biblioteca El control de chat local de salida opcional.
Valor devuelto
PartyErrorc_partyErrorSuccess si la operación asincrónica para crear un control de chat comenzó, o un código de error en caso contrario. Si este método produce un error, no se generará ningún cambio de estado relacionado. La forma legible del código de error se puede recuperar mediante PartyManager::GetErrorMessage().
Comentarios
Si este método devuelve un resultado correcto, se generará un PartyCreateChatControlCompletedStateChange para proporcionar el resultado de la operación asincrónica. Si la operación asincrónica se realiza correctamente, se generará un PartyChatControlCreatedStateChange. Si la operación produce un error, se generará un PartyChatControlDestroyedStateChange. Este método por sí mismo no hace que el control de chat sea visible para ningún dispositivo remoto. Para anunciar este control de chat a los dispositivos remotos, el título debe llamar a PartyNetwork::ConnectChatControl().Cuando se devuelve correctamente, este método invalida la memoria de cualquier matriz devuelta previamente por PartyManager::GetChatControls() o PartyDevice::GetChatControls() para el dispositivo local, ya que agrega de forma sincrónica el nuevo control de chat a las matrices. PartyManager::StartProcessingStateChanges() también invalida la memoria de estas matrices. El objeto
localChatControl devuelto será válido hasta que se haya generado un PartyChatControlDestroyedStateChange y todos los cambios de estado que hagan referencia al objeto se hayan devuelto a PartyManager::FinishProcessingStateChanges(). El idioma asociado a este control de chat se puede especificar opcionalmente mediante el parámetro
languageCode. Si no se especifica ningún idioma, se usará el idioma predeterminado del usuario, según lo determine la plataforma. El idioma se usa como el idioma hablado asociado a este control de chat para la transcripción y como el idioma de destino para las traducciones entrantes. Si el código de idioma especificado es en-US, por ejemplo, el audio de entrada de este control de chat se tratará como el idioma inglés (Estados Unidos) y se transcribirá como tal. Si la traducción está habilitada mediante PartyLocalChatControl::SetTranscriptionOptions() o PartyLocalChatControl::SetTextChatOptions(), las transcripciones entrantes del chat de voz o el chat de texto se traducirán al inglés (Estados Unidos). El código de idioma debe estar en formato BCP 47; los códigos de idioma admitidos se enumeran en Compatibilidad de idiomas. Especificar un código de idioma no admitido o no válido no hará que este método produzca un error, pero dará lugar a un error al generar las transcripciones asociadas a este control de chat. El código de idioma usado con este método se puede consultar mediante PartyLocalChatControl::GetLanguage().
Requisitos
Encabezado: Party.hConsulte también
PartyLocalDevicePartyCreateChatControlCompletedStateChange
PartyChatControlCreatedStateChange
PartyChatControlDestroyedStateChange
PartyManager::GetChatControls
PartyDevice::GetChatControls
PartyNetwork::ConnectChatControl
PartyLocalChatControl::GetLanguage
PartyLocalChatControl::SetTranscriptionOptions
PartyLocalChatControl::SetTranscriptionOptions