> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Directrices de experiencia de usuario de conversión de voz en texto y visualización de texto de PlayFab Party
> Describe las API de PlayFab Party y se centra en la implementación de la conversión de voz en texto y la visualización de texto, los requisitos y las soluciones de interfaz de usuario personalizadas para consola y PC.
La biblioteca de PlayFab Party ofrece a los creadores de juegos la posibilidad de atraer a más jugadores mediante opciones de chat de juego accesibles. Proporciona un medio para que el chat de voz se transcriba a texto y para que la entrada de texto se convierta en voz sintetizada. Puede implementar una solución de interfaz de usuario personalizada para estas características en su título. En XBOX y Windows, puede usar las API de la plataforma para implementar la interfaz de usuario correspondiente.
Este documento es la segunda parte de una serie de dos partes que abarca las soluciones de experiencia de usuario para la implementación de conversión de voz en texto y texto a voz. La [primera parte](/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines) se centra en la implementación de texto a voz, los requisitos y las soluciones de interfaz de usuario para consola y PC, mientras que este tema se centra en la implementación de conversión de voz en texto, los requisitos y las soluciones de interfaz de usuario para consola y PC.
## Escenarios de texto a voz y conversión de voz en texto
El siguiente gráfico le guía por los escenarios que los jugadores experimentarán cuando habilite las características de conversión de voz en texto y texto a voz. Describe el impacto en el usuario en tres fases de la experiencia de juego: configuración inicial, jugar a un juego y participar en el chat del juego.
| **Fase de la experiencia** | **Configuración** | **Juego** | **Chat** | **Mensaje** |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |
| **Objetivo** | **El usuario habilita la configuración** | **El usuario entra en un juego multijugador** | **El usuario envía una comunicación** | **El usuario recibe una comunicación** |
| **Acción** | Conversión de voz en texto
Alternativa para escuchar respuestas de voz | Inicia el juego
Entra en la sala multijugador
La superposición se abre cuando se inicia el chat del juego | El usuario habla | El usuario lee las respuestas de voz del equipo convertidas en texto en una superposición de chat de conversión de voz en texto |
| | Texto a voz
Alternativa para pronunciar respuestas de voz | Inicia el juego
Entra en la sala multijugador
El juego muestra el método de entrada de texto (teclado, campo de entrada, etc.) | El usuario escribe las respuestas mediante los métodos de entrada compatibles con la plataforma
Los mensajes escritos se convierten en voz sintetizada | El usuario escucha las respuestas de voz de los miembros del equipo |
| | Narración de la interfaz de usuario (en el juego)
Alternativa para leer los menús del juego y las respuestas de texto | La voz sintetizada del sistema operativo de XBOX guía al usuario para iniciar el juego
El juego usa la API Speech Synthesis para narrar las opciones de menú que llevan al usuario a la sala multijugador | Para los sistemas de mensajería de texto: los juegos usan la API Speech Synthesis para guiar al usuario para que inicie el teclado del sistema operativo de XBOX | Para los sistemas de mensajería de texto: los juegos usan la API Speech Synthesis para narrar las respuestas |
| | Narrador (sistema operativo de XBOX)
Alternativa para leer los menús de XBOX | La voz sintetizada del sistema operativo de XBOX guía al usuario para iniciar el juego | Para los sistemas de mensajería de texto: se narra un teclado virtual mientras el usuario escribe un mensaje | N/D |
## Descripción de la API
### Conversión de voz en texto
#### Habilitación de la transcripción
La transcripción del audio entrante para el usuario asociado a un control de chat local se puede habilitar llamando a [`PartyLocalChatControl::SetTranscriptionOptions()`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions). Cuando se complete la operación, [`PartyManager::StartProcessingStateChanges()`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) proporcionará un [`PartySetTranscriptionOptionsCompletedStateChange`](/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange) que indica si la operación asincrónica se realizó correctamente.
#### Recepción de transcripciones
Cuando se envía audio a un control de chat asociado a un usuario local que ha habilitado la transcripción, el audio se transcribirá. Cada transcripción se indicará mediante un [`PartyVoiceChatTranscriptionReceivedStateChange`](/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange) proporcionado por `PartyManager::StartProcessingStateChanges()`. El hablante, los receptores y el texto de la transcripción se especificarán en el cambio de estado. Además, el cambio de estado especificará si el texto de la transcripción es una frase `Hypothesis` o `Final`. Una frase `Hypothesis` es una instantánea del proceso de transcripción que indica un refinamiento iterativo del texto de la transcripción. Opcionalmente, estas se pueden usar para mejorar la capacidad de respuesta percibida del proceso de transcripción. Una frase `Final` representa el final del proceso de transcripción después de que un usuario haya completado una oración o frase.
#### Visualización de transcripciones
Cuando se recibe el texto de la transcripción, debe mostrarse según las siguientes directrices de diseño de experiencia de usuario. La API [Windows::Gaming::UI::GameChatOverlay](https://learn.microsoft.com/en-us/uwp/api/windows.gaming.ui.gamechatoverlay) o `Windows::Xbox::UI::Accessibility` se puede usar en Windows o XBOX, respectivamente, para usar la interfaz de usuario de chat de texto predeterminada del sistema, que se ha diseñado para cumplir estas directrices.
## Detección
En XBOX y Windows, los usuarios pueden encontrar la configuración de texto a voz y conversión de voz en texto en la sección **Accesibilidad** en **Configuración** de la pantalla principal de XBOX (consola XBOX) o de la aplicación XBOX (Windows 10). La configuración se controla mediante botones de alternancia que habilitan o deshabilitan las características para todos los juegos de XBOX específicos del perfil de usuario que se integran con la configuración de la plataforma. Para el resto de plataformas, consulte sus directrices de accesibilidad para conocer las ubicaciones de la configuración de texto a voz y conversión de voz en texto.
Si su juego decide agregar configuraciones adicionales que son solo específicas del juego, deben colocarse dentro del juego. En general, las opciones de accesibilidad pertenecen al menú de configuración u opciones del juego. Idealmente, la configuración debería estar disponible mediante la pulsación de un botón dedicado y ser accesible desde cualquier pantalla o, al menos, desde el menú Pausa.
## Guía de experiencia de usuario para crear una ventana de conversación personalizada
### Procedimientos recomendados generales
Los subtítulos y la transcripción del chat de voz abordan un desafío similar: mostrar texto conversacional a gran velocidad, superpuesto a contenido multimedia enriquecido. La documentación sobre subtítulos puede aplicarse a una ventana de conversación.
#### Aspectos básicos
1. Alto contraste entre el texto y el fondo.
2. Evite presentar demasiado texto en pantalla a la vez.
3. Use un tamaño de texto lo suficientemente grande para el tamaño de la pantalla.
#### Buenas prácticas
1. Asegúrese de que los usuarios puedan encontrar y habilitar la configuración de texto a voz antes de participar en el chat del juego.
2. Evite conflictos con otros elementos de la interfaz de usuario.
3. Al apilar varias respuestas, agregue las cadenas más recientes en la parte inferior.
4. Distinga entre hablantes.
5. Use una fuente clara y legible.
6. Permita que el usuario personalice la ventana de conversación y el contenido.
### Tamaño de la ventana
Para garantizar una experiencia equivalente para todos sus jugadores, es fundamental tener en cuenta tanto las necesidades del usuario como las necesidades de la interfaz de usuario del juego.
En esta sección se explica un método para determinar la mejor visualización, en función de:
* El comportamiento de chat del usuario.
* Diseños de interfaz de usuario variables que usan el chat del juego (salas, configuración del juego, sesión de juego).
* El impacto de la interfaz de usuario invocable por el título (TCUI) (por ejemplo, superposiciones, notificaciones del sistema, teclado virtual).
* Requisitos de presentación, como fuentes y formato.
#### Comportamiento de chat de los usuarios
Las distintas características del juego generarán una densidad de chat variable. Por ejemplo, la sala del juego durante la sesión de juego y el resumen de fin de partida son momentos en los que se usa el chat del juego. Sin embargo, los tipos de discusiones cambian los objetivos de la pantalla. Conocer el tipo de discusión puede ayudar a evaluar si una ventana de conversación es crítica u opcional para las necesidades del juego.
Tipos de discusión
* **Conversación informal**. No es crítica para lograr los objetivos. Por ejemplo, intereses comunes, exclamaciones, socialización.
* **Funcional**. Crítica para lograr los objetivos del juego. Por ejemplo, coordinar la estrategia con su equipo.
#### Longitud del chat: requisitos mínimos
Los tipos de discusión en el chat del juego influyen en una amplia gama de tipos de respuestas de un único usuario (desde saludos y confirmaciones breves hasta respuestas instructivas y descriptivas más largas). Una vez que haya determinado un tipo de discusión principal para cada pantalla, puede empezar a hacer algunas suposiciones generales sobre el tipo y la longitud de las respuestas.
Investigar la actividad de chat de su juego proporcionará los resultados más precisos. Requiere identificar patrones comunes en las conversaciones de varios usuarios. Una solución es realizar una prueba de investigación de usuarios, usando la funcionalidad de conversión de voz en texto dentro de su juego para capturar los datos de investigación de usuarios de los participantes. Otra sugerencia es ver transmisiones de juegos de géneros similares y hacer un seguimiento de los patrones de conversación.
Esos datos se pueden aplicar después a esta sencilla estrategia para determinar la longitud de la conversación:
* **Frecuencia de respuesta**: determine cuántas respuestas se intercambiaron antes de una pausa y luego calcule el promedio de esas respuestas para llegar a un número final. *Ejemplo: dos jugadores conversando promediaron cinco respuestas antes de que se produjera una pausa.*
* **Longitud de respuesta**: determine el promedio de palabras y caracteres de una única respuesta. *Ejemplo: una única respuesta promedió 10 palabras y 35 caracteres (con espacios) por respuesta.*
* **Formato**: cada cambio de estado relacionado con el chat incluye información útil para ayudar a visualizarlo. Las longitudes de cada campo deben tenerse en cuenta al determinar el formato. En el ejemplo siguiente, el **tipo de mensaje**, es decir, si el mensaje es el resultado de la conversión de voz en texto o de un mensaje de texto, se puede inferir del tipo de cambio de estado. Un `PartyVoiceChatTranscriptionReceivedStateChange` siempre indicará texto que es el resultado de una entrada de voz, y un [`PartyChatTextReceivedStateChange`](/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange) siempre indicará texto que es el resultado de una entrada de texto. El **origen de la respuesta**, es decir, quién envió la comunicación, y la propia **respuesta** se pueden determinar mediante los campos de cada cambio de estado.
#### Tamaño y tipo de fuente
Elegir una fuente legible es importante para los jugadores que leen cualquier texto de la interfaz de usuario en pantalla, algunos de los cuales pueden tener baja visión.
Verdana es la fuente más legible que distribuye Microsoft. Incluso mejor que Verdana por sí sola es presentar la fuente con alto contraste (negro puro sobre blanco puro o viceversa) y en tamaños grandes. El tamaño, el contraste y la forma de las letras son los tres factores más importantes en la legibilidad (en ese orden de prioridad).
*Ejemplo: distintos tipos de letra del mismo tamaño pueden variar en legibilidad.*
Se recomienda un mínimo de **28 px** para el texto de la interfaz de usuario a 1080p (14 sp) para las transcripciones de chat presentadas en una experiencia de 10 pies. Al igual que los subtítulos, estas se muestran durante un tiempo limitado, por lo que el texto debe ser notablemente más grande que el mínimo aceptable (24 pt para 10 pies) para el resto de la interfaz de usuario.
#### Cálculo de los requisitos finales de tamaño mínimo
Ahora que tiene la frecuencia media de respuesta, la longitud de respuesta, las consideraciones de formato y el tamaño y tipo de fuente, puede determinar el requisito de tamaño de la ventana:
*Ejemplo: el resultado de usar las especificaciones anteriores dentro de un tamaño de ventana de **525 px (ancho) x 395 px (alto)**.*
Empiece a probar su diseño usando **ConversationWindow\_Template.ai**. Vaya a [Recursos](#resources) para obtener el archivo nativo de Adobe Illustrator (.ai).
### Posición y proporción
Ahora que tiene los requisitos mínimos de texto para la ventana de conversación, puede empezar a probar el posicionamiento y la proporción de tamaño.
#### Posicionamiento: relativo frente a fijo
Alinear la ventana de conversación con un formato de cuadrícula proporciona un conjunto de entradas muy sencillo que puede escalar independientemente de la resolución de pantalla. Por ejemplo, la interfaz de usuario de conversión de voz en texto del sistema operativo de XBOX hace referencia a nueve cuadrantes (izquierda/superior, izquierda/centro, izquierda/inferior, medio/superior, etc.) para el posicionamiento.
Si su juego genera salida en varias resoluciones de pantalla (4K, PC), no tendrá que preocuparse por escalar valores de píxeles X, Y de 1080p a un tamaño de pantalla diferente.
Al tener un número predeterminado de posiciones relativas, no tendrá que luchar con código heredado para mantener un posicionamiento perfecto en píxeles de los elementos de diseño, las fuentes o las áreas seguras. Su diseño garantiza una posición relativa en su lugar.
Considere la posibilidad de hacer referencia a varias posiciones para adaptarse a la complejidad variable de las pantallas:
* Identifique las pantallas donde la actividad del chat del juego es crítica.
* Evite inhibir la interacción. (Consulte la nota)
* Evite ocultar detalles críticos. (Consulte la nota)
Tenga cuidado de posicionar la ventana de conversación de modo que no inhiba la actividad del juego. Esto garantizará que los usuarios de conversión de voz en texto puedan disfrutar de una experiencia comparable a la de otros usuarios.
### Personalización controlada por el usuario
Puede haber pantallas en las que simplemente no haya espacio para acomodar una ventana de conversación de ningún tamaño.
*Ejemplo: la interfaz de usuario de resultados de fin de partida ocupa toda la pantalla. Una ventana de conversación corre el riesgo de cubrir estadísticas críticas.*
### Soluciones para conflictos entre la interfaz de usuario del juego y la ventana de conversación
1. **El usuario debe poder deshabilitar la característica mediante el sistema operativo**.\
Idealmente, el usuario tiene la opción de salir del juego y activar o desactivar la opción de conversión de voz en texto mediante la configuración de Facilidad de acceso.
* **Impacto en la interfaz de usuario: NINGUNO**
* **Impacto en la experiencia de usuario: DEFICIENTE**
*Ejemplo: deshabilitación de la configuración de conversión de voz en texto mediante la configuración del sistema operativo. (Esto muestra una ruta crítica para la consola XBOX One)*
2. **El juego proporciona un método para que los usuarios minimicen la ventana**.
Tener una configuración de conversión de voz en texto para minimizar o mover la ventana ofrece flexibilidad adicional para el diseñador y el usuario.
* **Impacto en la interfaz de usuario: MODERADO**
Requiere agregar un botón para minimizar/maximizar la ventana de chat a un menú de configuración del juego. Se recomienda que esta opción aparezca solo cuando la conversión de voz en texto esté habilitada.
* **Impacto en la experiencia de usuario: BUENO**
Se trata de una solución de 3 clics donde los menús de configuración aparecen en el juego.
*Ejemplo: minimizar/maximizar la ventana de conversión de voz en texto mediante el menú Opciones del juego (ruta crítica de consola XBOX/PC*
*Ejemplo de consola: agregue una configuración de conversión de voz en texto en el menú Pausa.*
*Ejemplo de PC: agregue una configuración de conversión de voz en texto en el menú Pausa.*
Permitir que los usuarios minimicen o maximicen la ventana de conversación pone la elección en sus manos. El juego no tiene que intentar evitar comprometer espacio crítico de pantalla.
Las pantallas del juego que no requieren respuestas inmediatas dan a los usuarios tiempo para desviar el foco y editar su configuración. Pueden minimizar o maximizar la ventana sin destruir la sesión. Mantenga la navegación hacia y desde esta configuración lo más eficiente posible.
Para las pantallas del juego que sí requieren respuestas inmediatas, o cuando apuntar y hacer clic (PC) no es una opción, se puede asignar directamente un botón o un comando de teclado.
*Ejemplo de consola: se asigna un botón para activar o desactivar la visualización y se anota en la leyenda.*
*Ejemplo de PC: se asigna un botón para activar o desactivar la visualización y se anota en la leyenda.*
#### Requisitos funcionales
* La conversación se sigue registrando mientras la ventana está minimizada.
* El usuario puede expandir y ver las respuestas más recientes. (El usuario no ve un historial de respuestas perdidas.)
* Esta opción aparece cuando se detecta que la configuración de conversión de voz en texto del perfil de un usuario está habilitada.
* Esta configuración no invalidaría la configuración de conversión de voz en texto del perfil del sistema operativo.
### Frecuencia de visualización
La actividad de chat fluctuará entre los jugadores durante las sesiones de juego. No tiene ningún valor mantener abierta una ventana de chat vacía cuando los jugadores no están conversando.
Cierre automáticamente la ventana cuando el chat haya estado inactivo durante un período establecido.
*Ejemplo: la ventana de conversión de voz en texto se cierra después de 15 s de inactividad. Este número se basa en el tiempo que tardaría un usuario en leer un mensaje de 280 caracteres.*
Vale la pena probar varias configuraciones para asegurarse de que abrir y cerrar una ventana no distraiga demasiado en una pantalla de juego con mucha actividad.
### Desplazamiento
Durante las conversaciones en curso, la ventana debe facilitar una vista de las respuestas más recientes. Las respuestas más recientes se muestran en la parte inferior de las respuestas y se desplazan hacia arriba.
El desplazamiento automático es una solución que facilita la administración de las conversaciones tanto para los desarrolladores como para los usuarios. Es lo que más se acerca a imitar una conversación fluida. Cuanto menos esfuerzo tenga que hacer un usuario para administrar la vista, más tiempo tendrá para centrarse en el juego. Una barra de desplazamiento manual requeriría cambiar el foco del mando, lo que puede ser molesto durante el juego activo.
### Disparidad visual
Puede resultar tentador diseñar esta ventana de chat para que coincida con el estilo de su interfaz de usuario. Sin embargo, la ventana de chat tiene una función específica, única con respecto a otros componentes del juego. Presenta información que se origina fuera de las instrucciones del juego.
Es información del juego que también usa texto y marcos. Un usuario podría confundir la intención de la ventana de chat con componentes reales del juego si tienen un aspecto demasiado similar. Por lo tanto, la superposición de chat debe poseer atributos únicos que la separen claramente de la interfaz de usuario del juego. El grado de disparidad queda a discreción del diseñador.
### Cierre o destrucción de la ventana de conversación
Un juego debe determinar cuándo la ventana de conversación permanece activa (mientras un usuario realiza varias tareas) o cuándo debe cerrarse (por ejemplo, cuando un usuario sale de una sesión de chat). Tenga en cuenta que esta ventana representa una conversación de chat en directo y no debe confundirse con la mensajería instantánea (IM). Por ejemplo, si un usuario se aleja de su consola o pausa un juego, la conversación continuará, pero se habrá perdido las respuestas que se produjeron antes de su regreso.
Recomendación de experiencia de usuario: mantenga la ventana activa cuando un juego esté restringido o en pausa. Cierre la ventana cuando el juego se cierre.
## Interfaz de usuario invocable por el título (TCUI)
*Ejemplo de consola: la Guía de XBOX One es TCUI y tiene una superposición transparente que atenúa la pantalla.*
Es habitual que la interfaz de usuario del sistema de una plataforma sea la capa visible "superior" de cualquier interfaz de usuario de juego o aplicación. Por ejemplo, la interfaz de usuario iniciada por el sistema operativo de XBOX One (mensajes de error, un teclado virtual, notificaciones del sistema, la Guía de XBOX One, el selector de personas y otros elementos) aplica una superposición negra semitransparente a pantalla completa con su ventana de contenido.
* **Impacto en la experiencia de usuario**: la visibilidad de la ventana de conversación quedará oscurecida.
## Conclusión
Las API de texto a voz y conversión de voz en texto de PlayFab Party son características muy eficaces para incluir a una gama más amplia de usuarios en un juego y en las conversaciones de juego. Cuanto más interactúen los jugadores y desarrollen relaciones, más probable será que sigan jugando. Esta guía le ayudará a garantizar la mejor experiencia de usuario posible.
## Recursos
### Plantillas de diseño
* [PlayFab Parties\_AI\_Templates.zip](https://aka.ms/gamechat-ai-templates)
Contiene:
* PlayFab Parties\_9GridTemplate.ai
* ConversationWindow\_Template.ai
### Directrices de menús de narración de texto a voz
* [Interacciones de voz](https://learn.microsoft.com/en-us/windows/apps/design/input/speech-interactions)
* [API de síntesis de voz (Windows)](https://learn.microsoft.com/en-us/uwp/api/Windows.Media.SpeechSynthesis)
### Serie de experiencia de usuario de texto a voz y conversión de voz en texto de PlayFab Party
* Parte 1: [Guía de experiencia de usuario de texto a voz y entrada de texto de PlayFab Party](/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines)
* Parte 2: Guía de experiencia de usuario de conversión de voz en texto y visualización de texto de PlayFab Party
### Documentación del SDK
* "Accessible in-game chat overview" en el SDK de PlayFab (consulte [Descargas del SDK](https://developer.xboxlive.com/live/development/Pages/Downloads.aspx))
### Guía de accesibilidad
* Griffiths, Gareth. [Subtitles: Increasing Game Accessibility, Comprehension](https://www.gamasutra.com/view/feature/132315/subtitles_increasing_game_.php?print=1)
*Gamasutra*
* [Game Accessibility Guidelines](http://gameaccessibilityguidelines.com/)
Una referencia sencilla para el diseño de juegos inclusivos
### Diseño inclusivo
* [Iniciativa Gaming for Everyone de XBOX](https://news.microsoft.com/gamingforeveryone/)
* [Diseño inclusivo](https://www.microsoft.com/design/inclusive)
Kit de herramientas de diseño y educación de Microsoft
* Kojouharov, Stefan. [10 Tips on Creating an Addictive ChatBot](https://chatbotslife.com/10-tips-on-creating-an-addictive-chatbot-experience-b796ea6d1178#.ka4jz0vk7)
Se hace referencia a él en este documento para obtener sugerencias sobre interfaces de usuario conversacionales.
## Related topics
- [Directrices de experiencia de usuario de texto a voz y entrada de texto de PlayFab Party](/es/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines.md)
- [Uso de la API de C++ de Game Chat 2](/es/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [Características de PlayFab Party](/es/services/playfab/multiplayer/networking/party-features.md)
- [Azure PlayFab Party](/es/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)
- [Notas de la versión del complemento de PlayFab Party para Unity](/es/services/playfab/multiplayer/networking/party-unity-release-notes.md)