Syntaxe
Paramètres
options PartyVoiceChatTranscriptionOptions
Options associées à la transcription du clavardage vocal, par exemple quels contrôles de clavardage doivent générer des transcriptions pour le contrôle de clavardage local, et si ces transcriptions doivent être traduites dans la langue du contrôle de clavardage local.
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.
Valeur de retour
PartyErrorc_partyErrorSuccess si l’opération asynchrone de définition des options de transcription 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 au moyen de PartyManager::GetErrorMessage().
Remarques
La transcription est le processus de génération de chaînes représentant les phrases prononcées dans le clavardage vocal. Les options spécifiées au moyen deoptions indiquent les contrôles de clavardage qui doivent générer ces chaînes de transcription, lesquelles sont ensuite fournies au contrôle de clavardage local au moyen de PartyVoiceChatTranscriptionReceivedStateChange. Seuls les contrôles de clavardage configurés, au moyen de PartyLocalDevice::CreateChatControl(), pour utiliser une langue prenant en charge la transcription fournissent des transcriptions.
La fonctionnalité de transcription de la parole en texte utilise en interne les estimations de régions disponibles et de mesures de latence pour optimiser l’utilisation du service. Si l’option PartyOption::RegionUpdateConfiguration a été utilisée pour configurer un mode de mise à jour PartyRegionUpdateMode::Deferred, la récupération de l’ensemble des régions disponibles et la mesure de la qualité de connexion à celles-ci n’ont peut-être pas encore commencé, ou la dernière mise à jour a peut-être dépassé l’ancienneté d’intervalle d’actualisation configurée. Si l’appareil local n’est actuellement ni en cours de connexion ni connecté à un réseau, et que l’application spécifie des indicateurs d’option incluant PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState, SetTranscriptionOptions() garantit que toute mise à jour différée des régions a commencé et que le PartyRegionsChangedStateChange associé est fourni avant la fin de cet appel, signalée par le PartySetTranscriptionOptionsCompletedStateChange.