Inicio rápido: Instalación del SDK de Voz

Documentación de referencia | Paquete (NuGet) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para C#.

Los ejemplos de código de la documentación se escriben en C# 8 y se ejecutan en .NET standard 2.0.

Requisitos de la plataforma

El SDK de Voz para C# es compatible con Windows, Linux y macOS.

Windows

En Windows debe usar la arquitectura de destino de 64 bits. Se requiere Windows 10 o posterior.

Instale el Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022 para su plataforma. Durante la primera instalación del paquete, es posible que deba reiniciar.

Linux

El SDK de Voz para C# solo admite las siguientes distribuciones en las arquitecturas x64, ARM32 y ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de Voz depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de hilos POSIX, libpthreads.
• La biblioteca OpenSSL, versión 1.x (libssl1) o 3.x (libssl3), y certificados (ca-certificates).
• La biblioteca compartida para aplicaciones ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Debian 11/12

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

Ejecute estos comandos:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Ejecute estos comandos:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Se requiere una versión de macOS 10.14 o posterior.

Instale el SDK de Voz para C#

El SDK de voz para C# está disponible como paquete NuGet e implementa el estándar 2.0 de .NET. Para más información, consulte Microsoft.CognitiveServices.Speech.

Terminal

El SDK de voz para C# se puede instalar desde la CLI de .NET con el siguiente comando dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

El SDK de voz para C# se puede instalar con el siguiente comando Install-Package:

Install-Package Microsoft.CognitiveServices.Speech

Puede seguir estas guías para ver más opciones.

.NET

Esta guía muestra cómo instalar el SDK de voz para una aplicación de consola de .NET Framework (Windows).

Esta guía requiere:

• Microsoft Visual C++ Redistributable para Visual Studio 2019 para la plataforma de Windows Durante la primera instalación es posible que deba reiniciar.
• Visual Studio.

Creación de un proyecto de Visual Studio e instalación del SDK de Voz

El siguiente paso consiste en instalar el paquete NuGet del SDK de Voz para que pueda hacer referencia a él en el código. Para ello, primero puede ser necesario crear un proyecto helloworld. Si ya tiene un proyecto con la carga de trabajo de desarrollo de escritorio de .NET disponible, puede usar ese proyecto y pasar directamente a Uso del Administrador de paquetes NuGet para instalar el SDK de Voz.

Creación de un proyecto helloworld

1. Abierto Visual Studio.

2. En Comenzar, seleccione Crear un nuevo flujo.

3. En Crear un proyecto, elija Aplicación de consola (.NET Framework) y seleccione Siguiente.

4. En Configure su nuevo proyecto,para el nombre de proyecto escriba helloworld , elija o cree la ruta de acceso del directorio en Ubicación y seleccione Crear.

5. En la barra de menús de Visual Studio, seleccione Herramientas>Obtener herramientas y características. Este paso abre el Instalador de Visual Studio y muestra el cuadro de diálogo Modificando.

6. Compruebe si la carga de trabajo Desarrollo de escritorio de .NET está disponible. Si aún no está instalada la carga de trabajo, selecciónela y elija Modificar para iniciar la instalación. La descarga e instalación pueden tardar unos minutos.

   Si la opción Desarrollo de escritorio de .NET ya está seleccionada, elija Cerrar para cerrar el cuadro de diálogo.

   

7. Cierre el Instalador de Visual Studio.

Uso del Administrador de paquetes Nuget para instalar el SDK de Voz

1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto helloworld y seleccione Administrar paquetes NuGet para mostrar el Administrador de paquetes NuGet.

2. En la esquina superior derecha, busque el cuadro desplegable Origen del paquete y asegúrese de que nuget.org está seleccionado.

   

3. En la esquina superior izquierda, seleccione Examinar.

4. En el cuadro de búsqueda, escriba Microsoft.CognitiveServices.Speech y seleccione Entrar.

5. En los resultados de la búsqueda, seleccione el paquete Microsoft.CognitiveServices.Speech y, después, seleccione Instalar para instalar la versión estable más reciente.

   

6. Acepte todos los contratos y licencias para iniciar la instalación.

   Después de instalar el paquete aparecerá una confirmación en la ventana Consola del administrador de paquetes.

Elección de la arquitectura de destino

Para compilar y ejecutar la aplicación de consola, cree una configuración de plataforma que coincida con la arquitectura del equipo.

1. En el menú, seleccione Compilar>Administrador de configuración. Aparecerá el cuadro de diálogo Administrador de configuración.

2. En el cuadro desplegable Plataforma de soluciones activas, seleccione Nuevo. Aparecerá el cuadro de diálogo Nueva plataforma de solución.

   

3. En el cuadro desplegable Escriba o seleccione la nueva plataforma:

   • Si está ejecutando Windows de 64 bits, seleccione x64.
   • Si está ejecutando Windows de 32 bits, seleccione x86.

4. Seleccione Aceptar y, después, Cerrar.

.NET Core

Esta guía muestra cómo instalar el SDK de voz para una aplicación de consola .NET Core. .NET Core es una plataforma de .NET multiplataforma de código abierto que implementa la especificación .NET Standard.

Esta guía requiere:

• Microsoft Visual C++ Redistributable para Visual Studio 2019 para la plataforma de Windows Durante la primera instalación es posible que deba reiniciar.
• SDK de .NET Core.
• Visual Studio 2017.

Creación de un proyecto de Visual Studio e instalación del SDK de Voz

1. Inicie Visual Studio 2017.

2. Asegúrese de que la carga de trabajo Desarrollo multiplataforma de .NET Core esté disponible. Seleccione Herramientas>Obtener herramientas y características en la barra de menús de Visual Studio para abrir el Instalador de Visual Studio. Si esta carga de trabajo ya está habilitada, cierre el cuadro de diálogo.

   De lo contrario, seleccione Desarrollo multiplataforma de .NET Core y elija Modificar. La instalación de la nueva característica tardará un momento.

   

3. Cree una nueva aplicación de consola de .NET Core de Visual C# en el cuadro de diálogo Nuevo proyecto. En el panel izquierdo, expanda Instalados>Visual C#>.NET Core. Luego, seleccione Aplicación de consola (.NET Framework) . Para el nombre del proyecto, escriba helloworld.

   

4. Instale y haga referencia al paquete NuGet del SDK de Voz. En el Explorador de soluciones, haga clic con el botón derecho en la solución y seleccione Manage NuGet Packages for Solution (Administrar paquetes de NuGet para la solución).

   

5. Seleccione Examinar y, a continuación, en la esquina superior derecha, para Origen del paquete, seleccione nuget.org.

6. Busque el paquete Microsoft.CognitiveServices.Speech e instálelo en el proyecto helloworld.

   

7. Acepte la licencia que aparece para comenzar la instalación del paquete de NuGet.

   

Después de instalar el paquete, aparece una confirmación en la consola del Administrador de paquetes.

Unity

En esta guía se muestra cómo instalar el SDK de Voz para Unity.

Para el desarrollo de Unity, el SDK de voz es compatible con Windows Desktop (x86 y x64) o con la Plataforma universal de Windows (x86, x64, ARM/ARM64), Android (x86, ARM32/64), iOS (simulador x64 y ARM64) y Mac (x64).

Requisitos previos

Esta guía requiere:

• Microsoft Visual C++ Redistributable para Visual Studio 2019 para la plataforma de Windows Durante la primera instalación es posible que deba reiniciar.
• Unity 2018.3 o posterior con Unity 2019.1 que agrega compatibilidad con UWP ARM64.
• Visual Studio 2019. La versión 15.9 o posterior de Visual Studio 2017 también es aceptable.
• Para obtener compatibilidad con Windows ARM64, instale las herramientas de compilación opcionales para ARM64 y el SDK de Windows 10 para ARM64.
• En Android, un dispositivo Android basado en ARM (API 23: Android 6.0 Marshmallow o posterior) habilitado para el desarrollo con un micrófono que funcione.
• En iOS, un dispositivo iOS (ARM64) habilitado para el desarrollo con un micrófono que funcione.
• En macOS, un dispositivo Mac (x64) y la versión LTS más reciente de Unity 2019 (o posterior) para la compatibilidad integrada con acceso al micrófono en la configuración del reproductor de Unity.

Instale el SDK de Voz para Unity

Para instalar Speech SDK para Unity, siga estos pasos:

1. Descargue y abra el SDK de Voz para Unity. El SDK se empaqueta como un paquete de recursos de Unity (.unitypackage) y ya debe estar asociado a Unity. Cuando se abra el paquete de recursos, aparecerá el cuadro de diálogo Import Unity Package (Importar paquete de Unity). Es posible que tenga que crear y abrir un proyecto vacío para que funcione este paso.

2. Asegúrese de que se seleccionan todos los archivos y seleccione Import (Importar). Transcurridos unos instantes, el paquete de recursos de Unity se importa en el proyecto.

Para más información sobre la importación de paquetes de recursos en Unity, consulte la documentación de Unity.

UWP

Esta guía muestra cómo crear un proyecto de la Plataforma universal de Windows (UWP) e instalar el SDK de voz para C#. La Plataforma universal de Windows permite desarrollar aplicaciones que se ejecutan en cualquier dispositivo que admite Windows 10, incluidos PC, Xbox, Surface Hub y otros dispositivos.

Esta guía requiere:

• Microsoft Visual C++ Redistributable para Visual Studio 2019 para la plataforma de Windows Cuando se instala este archivo por primera vez, puede ser necesario reiniciar el sistema.
• Visual Studio.

Creación de un proyecto de Visual Studio e instalación del SDK de Voz

Para crear un proyecto de Visual Studio para el desarrollo de UWP, es necesario:

• Configurar las opciones de desarrollo de Visual Studio.
• Crear el proyecto y seleccionar la arquitectura de destino.
• Configurar la captura de audio.
• Instalar el SDK de Voz.

Configuración de las opciones de desarrollo de Visual Studio

Asegúrese de que Visual Studio está configurado correctamente para el desarrollo para UWP:

1. Abra Visual Studio para mostrar la ventana de inicio.

2. Seleccione Continuar sin código para ir al IDE de Visual Studio.

   

3. En la barra de menús de Visual Studio, seleccione Herramientas>Get Tools and Features (Obtener herramientas y características) para abrir el Instalador de Visual Studio y ver el cuadro de diálogo Modificar.

4. En la pestaña Cargas de trabajo, busque la carga de trabajo Desarrollo de la Plataforma universal de Windows. Si esa carga de trabajo ya está seleccionada, cierre el cuadro de diálogo Modificando y cierre el Instalador de Visual Studio. Omita el resto del procedimiento.

   

5. Seleccione Desarrollo de la Plataforma universal de Windows y elija Modificar.

6. En el cuadro de diálogo Antes de comenzar, seleccione Continuar para instalar la carga de trabajo de desarrollo para UWP. La instalación de la nueva característica puede tardar un rato.

7. Cierre el Instalador de Visual Studio.

Creación del proyecto

A continuación, cree el proyecto y seleccione la arquitectura de destino:

1. En la barra de menús de Visual Studio, seleccione Archivo>Nuevo>Proyecto para mostrar la ventana Crear un nuevo proyecto.

2. Busque y seleccione Aplicación vacía (Windows universal) . Asegúrese de seleccionar la versión de C# de este tipo de proyecto, en lugar de Visual Basic.

3. Seleccione Siguiente.

   

4. En el cuadro de diálogo Configurar el nuevo proyecto, en Nombre del proyecto, escriba helloworld.

5. En Ubicación, vaya a la carpeta en la que desea guardar el proyecto y selecciónela o créela.

6. Seleccione Crear.

   

7. En la ventana Nuevo proyecto de la Plataforma universal de Windows, en Versión mínima (segundo cuadro desplegable), seleccione Windows 10 Fall Creators Update (10.0; compilación 16299). Este es el requisito mínimo para el SDK de Voz.

8. En Versión de destino (primer cuadro desplegable), elija un valor idéntico o posterior al valor de Versión mínima.

   

9. Seleccione Aceptar. Vuelve al IDE de Visual Studio, con el nuevo proyecto creado y visible en el panel Explorador de soluciones.

   

10. Seleccione la arquitectura de la plataforma de destino. En la barra de herramientas de Visual Studio, busque el cuadro desplegable Plataformas de solución. Si no lo ve, seleccione Ver>Barra de herramientas>Estándar para mostrar la barra de herramientas que contiene Plataformas de solución.

    Si está ejecutando Windows de 64 bits, seleccione x64 en el cuadro desplegable. Windows de 64 bits puede ejecutar también aplicaciones de 32 bits, por lo que puede elegir x86, si lo prefiere.

    Nota

    El SDK de Voz es compatible con todos los procesadores compatibles con Intel, pero solo con las versiones x64 de los procesadores ARM.

Configuración de la captura de audio

Deje que el proyecto capture la entrada de audio:

1. En el Explorador de soluciones, seleccione Package.appxmanifest para abrir el manifiesto de aplicación del paquete.

2. Seleccione la pestaña Funcionalidades y, a continuación, seleccione la funcionalidad Micrófono.

   

3. En la barra de menús, seleccione Archivo>Guardar Package.appxmanifest para guardar los cambios.

Instale el SDK de Voz para UWP

Por último, instale el paquete NuGet del SDK de voz y haga referencia al SDK de voz en el proyecto:

1. En el Explorador de soluciones, haga clic con el botón derecho en la solución y seleccione Manage NuGet Packages for Solution para ir a la ventana NuGet: solución.

2. Haga clic en Examinar. En Origen del paquete, seleccione nuget.org.

   

3. En el cuadro de búsqueda, escriba Microsoft.CognitiveServices.Speech. Seleccione ese paquete después de que aparezca en los resultados de la búsqueda.

4. En el panel de estado del paquete situado junto a los resultados de la búsqueda, seleccione el proyecto HelloWorld.

5. Seleccione Instalar.

   

6. En el cuadro de diálogo Vista previa de los cambios, seleccione Aplicar.

7. En el cuadro de diálogo Aceptación de licencia, vea la licencia y, a continuación, seleccione Acepto. Comenzará la instalación del paquete.

   Una vez completada la instalación, el panel Salida muestra un mensaje similar al texto siguiente: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.

Xamarin

En esta guía se muestra cómo crear un proyecto de formularios de Xamarin e instalar el SDK de voz. Xamarin es una plataforma de código abierto para compilar aplicaciones modernas y de alto rendimiento para iOS, Android y Windows mediante .NET.

Para el desarrollo para Xamarin, el SDK de voz admite:

• Escritorio de Windows x86 y x64
• Plataforma universal de Windows x86, x64, ARM/ARM64
• Android x86, ARM32/64
• Simulador de iOS x64 y ARM64

Esta guía requiere:

• Microsoft Visual C++ Redistributable para Visual Studio 2019 para la plataforma de Windows Durante la primera instalación es posible que deba reiniciar.
• Visual Studio 2019.

Creación de un proyecto de Visual Studio e instalación del SDK de Voz

Para crear un proyecto de Visual Studio para el desarrollo de aplicaciones móviles multiplataforma con .NET y Xamarin, debe:

• Configurar las opciones de desarrollo de Visual Studio.
• Crear el proyecto y seleccionar la arquitectura de destino.
• Instalar el SDK de Voz.

Configuración de las opciones de desarrollo de Visual Studio

Asegúrese de que Visual Studio está configurado correctamente para el desarrollo para dispositivos móviles multiplataforma con .NET:

1. Abra Visual Studio 2019. A continuación, seleccione Continuar sin código.

2. En la barra de menús de Visual Studio, seleccione Herramientas>Obtener herramientas y características para abrir el Instalador de Visual Studio y ver el cuadro de diálogo Modificando.

3. En la pestaña Cargas de trabajo, busque la carga de trabajo Desarrollo para dispositivos móviles con .NET. Si esa carga de trabajo ya está seleccionada, cierre el cuadro de diálogo Modificando y cierre el Instalador de Visual Studio. Omita el resto del procedimiento.

   

4. Seleccione Desarrollo para dispositivos móviles con .NET y elija Modificar.

5. En el cuadro de diálogo Antes de comenzar, seleccione Continuar para instalar la carga de trabajo de desarrollo para dispositivos móviles con .NET. La instalación de la nueva característica puede tardar un rato.

6. Cierre el Instalador de Visual Studio.

Creación del proyecto

A continuación, cree el proyecto y seleccione la arquitectura de destino:

1. En la barra de menús de Visual Studio, seleccione Archivo>Nuevo>Proyecto para mostrar la ventana Crear un nuevo proyecto.

2. Busque y seleccione Aplicación móvil (Xamarin.Forms) .

3. Seleccione Next (Siguiente).

   

4. En el cuadro de diálogo Configurar el nuevo proyecto, en Nombre del proyecto, escriba helloworld.

5. En Ubicación, vaya a la carpeta en la que desea guardar el proyecto y selecciónela o créela.

6. Seleccione Crear.

   

7. En la ventana New Cross Platform App (Nueva aplicación multiplataforma), seleccione la plantilla en blanco y, a continuación, seleccione Android, iOS, y Windows (UWP). Seleccione Crear.

   

8. Seleccione Aceptar. Vuelve al IDE de Visual Studio, con el nuevo proyecto creado y visible en el panel Explorador de soluciones.

   

9. Seleccione la arquitectura de la plataforma de destino y el proyecto de inicio. En la barra de herramientas de Visual Studio, busque el cuadro desplegable Plataformas de solución. Si no lo ve, seleccione Ver>Barra de herramientas>Estándar para mostrar la barra de herramientas que contiene Plataformas de solución.

   Si está ejecutando Windows de 64 bits, seleccione x64 en el cuadro desplegable. Puede seleccionar x86 si lo desea porque Windows de 64 bits también puede ejecutar aplicaciones de 32 bits.

10. En el cuadro desplegable Proyectos de inicio, seleccione helloworld.UWP (Windows universal).

Instale el SDK de Voz para Xamarin

Instale el paquete NuGet del SDK de Voz y haga referencia al SDK de Voz en el proyecto:

1. En el Explorador de soluciones, haga clic con el botón derecho en la solución. Seleccione Administrar paquetes NuGet para la solución para ir a la ventana NuGet - Solución.

2. Haga clic en Examinar.

3. En Origen del paquete, seleccione nuget.org.

   

4. En el cuadro de búsqueda, escriba Microsoft.CognitiveServices.Speech. A continuación, seleccione ese paquete después de que aparezca en los resultados de la búsqueda.

   Nota

   La biblioteca de iOS dentro del paquete NuGet Microsoft.CognitiveServices.Speech no tiene bitcode habilitado. Si necesita la biblioteca de bitcode en la aplicación, use el paquete NuGet Microsoft.CognitiveServices.Speech.Xamarin.iOS específicamente para el proyecto de iOS.

5. En el panel de estado del paquete situado junto a los resultados de la búsqueda, seleccione todos los proyectos.

6. Seleccione Instalar.

   

7. En el cuadro de diálogo Vista previa de los cambios, seleccione Aceptar.

8. En el cuadro de diálogo Aceptación de licencia, vea la licencia y, a continuación, seleccione Acepto. Instale la referencia de paquete del SDK de Voz en todos los proyectos.

   Una vez completada correctamente la instalación, es posible que vea la siguiente advertencia para helloworld.iOS. Esta advertencia es un problema conocido y no debe afectar a la funcionalidad de la aplicación.

   Could not resolve reference "C:\Users\Default\.nuget\packages\microsoft.cognitiveservices.speech\1.7.0\build\Xamarin.iOS\libMicrosoft.CognitiveServices.Speech.core.a". If this reference is required by your code, you may get compilation errors.
   

El SDK de Voz ya está instalado. Ahora puede eliminar o volver a usar el proyecto helloworld que creó en los pasos anteriores.

Documentación de referencia | Paquete (NuGet) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para C++.

Requisitos de la plataforma

El SDK de Voz para C++ es compatible con Windows, Linux y macOS.

Windows

En Windows debe usar la arquitectura de destino de 64 bits. Se requiere Windows 10 o posterior.

Instale el Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022 para su plataforma. Durante la primera instalación del paquete, es posible que deba reiniciar.

Linux

El SDK de Voz para C++ solo admite las siguientes distribuciones en las arquitecturas x64, ARM32 y ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de Voz depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de hilos POSIX, libpthreads.
• La biblioteca OpenSSL, versión 1.x (libssl1) o 3.x (libssl3), y certificados (ca-certificates).
• La biblioteca compartida para aplicaciones ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Debian 11/12

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

Ejecute estos comandos:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Ejecute estos comandos:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Se requiere una versión de macOS 10.14 o posterior.

Instale el SDK de Voz para C++

El SDK de voz para C++ está disponible como paquete NuGet. Para más información, consulte Microsoft.CognitiveServices.Speech.

Terminal

El SDK de voz para C++ se puede instalar desde la CLI de .NET con el siguiente comando dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

El SDK de voz para C++ se puede instalar con el siguiente comando Install-Package:

Install-Package Microsoft.CognitiveServices.Speech

Puede seguir estas guías para ver más opciones.

Linux

En esta guía se muestra cómo instalar el SDK de Voz para Linux.

Use el procedimiento siguiente para descargar e instalar el SDK. Los pasos incluyen la descarga de las bibliotecas y los archivos de encabezado necesarios, como un archivo .tar.

1. Elija un directorio para los archivos del SDK de Voz. Establezca la variable de entorno SPEECHSDK_ROOT para que apunte a ese directorio. Esta variable facilita la referencia al directorio en futuros comandos.

   Para usar el directorio speechsdk en el directorio principal, ejecute el siguiente comando:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Si no existe el directorio, créelo:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Descargue y extraiga el archivo .tar.gz que contiene los archivos binarios del SDK de voz:

   wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary
   tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
   

4. Valide el contenido del directorio de nivel superior del paquete extraído:

   ls -l "$SPEECHSDK_ROOT"
   

   La lista de directorios debe contener los archivos de licencia y aviso del asociado. La lista debe contener también un directorio include que contenga archivos de encabezado (.h) y un directorio lib que contenga bibliotecas para arm32, arm64, x64 y x86.

   Ruta de acceso	Descripción
   license.md	Licencia
   ThirdPartyNotices.md	Avisos de asociados
   REDIST.txt	Aviso de redistribución
   include	Archivos de encabezado necesarios para C++
   lib/arm32	Biblioteca nativa para ARM32 necesaria para vincular la aplicación
   lib/arm64	Biblioteca nativa para ARM64 necesaria para vincular la aplicación
   lib/x64	Biblioteca nativa para x64 necesaria para vincular la aplicación
   lib/x86	Biblioteca nativa para x86 necesaria para vincular la aplicación

macOS

En esta guía se muestra cómo instalar el SDK de Voz para C++ en macOS 10.14 o versiones posteriores. Los pasos incluyen la descarga de las bibliotecas y los archivos de encabezado necesarios, como un archivo .zip.

1. Elija un directorio para los archivos del SDK de Voz. Establezca la variable de entorno SPEECHSDK_ROOT para que apunte a ese directorio. Esta variable facilita la referencia al directorio en futuros comandos.

   Para usar el directorio speechsdk en el directorio principal, ejecute el siguiente comando:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Si no existe el directorio, créelo:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Descargue y extraiga el archivo .zip que contiene el paquete XCFramework del SDK de voz:

   wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
   unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
   

4. Valide el contenido del directorio de nivel superior del paquete extraído:

   ls -l "$SPEECHSDK_ROOT"
   

   El directorio debe contener los archivos de licencia y el aviso del asociado y un directorio MicrosoftCognitiveServicesSpeech.xcframework.

Windows

En esta guía se muestra cómo instalar el SDK de Voz para C++ en sistemas operativos de escritorio de Windows.

Esta guía de configuración requiere:

• Microsoft Visual C++ Redistributable para Visual Studio para la plataforma de Windows. Durante la primera instalación es posible que deba reiniciar.
• Visual Studio.

Creación de un proyecto en Visual Studio e instalación del SDK de voz

Para crear un proyecto de Visual Studio para el desarrollo de escritorio de C++, es necesario:

• Configurar las opciones de desarrollo de Visual Studio.
• Crear el proyecto.
• Seleccionar la arquitectura de destino.
• Instalar el SDK de Voz.

Configuración de las opciones de desarrollo de Visual Studio

Para empezar, asegúrese de que Visual Studio está configurado correctamente para el desarrollo de escritorio de C++:

1. Abra Visual Studio 2019 para mostrar la ventana de inicio.

2. Seleccione Continuar sin código para ir al IDE de Visual Studio.

   

3. En la barra de menús de Visual Studio, seleccione Herramientas>Get Tools and Features (Obtener herramientas y características) para abrir el Instalador de Visual Studio y ver el cuadro de diálogo Modificar.

4. En la pestaña Cargas de trabajo, en Windows, busque la carga de trabajo Desarrollo para el escritorio con C++. Si no está seleccionada esa carga de trabajo, selecciónela.

   

5. En la pestaña Componentes individuales, busque Administrador de paquetes NuGet. Si no está ya seleccionado, selecciónelo.

6. Seleccione Cerrar o Modificar. El nombre del botón varía en función de si seleccionó alguna característica para la instalación.

   Si selecciona Modificar, comenzará la instalación. Este proceso puede tardar unos minutos.

7. Cierre el Instalador de Visual Studio.

Creación del proyecto

A continuación, cree el proyecto y seleccione la arquitectura de destino:

1. En la barra de menús de Visual Studio, seleccione Archivo>Nuevo>Proyecto para mostrar la ventana Crear un nuevo proyecto.

2. Busque y seleccione Aplicación de consola. Asegúrese de seleccionar la versión de C++ de este tipo de proyecto, en lugar de C# o de Visual Basic.

3. Seleccione Next (Siguiente).

   

4. En el cuadro de diálogo Configurar el nuevo proyecto, en Nombre del proyecto, escriba helloworld.

5. En Ubicación, seleccione o cree la carpeta en la que desea guardar el proyecto y elija Crear.

   

6. Seleccione la arquitectura de la plataforma de destino. En la barra de herramientas de Visual Studio, busque el cuadro desplegable Plataformas de solución. Si no lo ve, seleccione Ver>Barra de herramientas>Estándar para mostrar la barra de herramientas que contiene Plataformas de solución.

   Si está ejecutando Windows de 64 bits, seleccione x64 en el cuadro desplegable. Windows de 64 bits puede ejecutar también aplicaciones de 32 bits, por lo que puede elegir x86, si lo prefiere.

Instale el SDK de Voz con Visual Studio

Por último, instale el paquete NuGet del SDK de Voz y haga referencia al SDK de Voz en el proyecto:

1. En el Explorador de soluciones, haga clic con el botón derecho en la solución y seleccione Manage NuGet Packages for Solution (Administrar paquetes NuGet para la solución) para ir a la ventana NuGet - Solución.

2. Haga clic en Examinar.

3. En Origen del paquete, seleccione nuget.org.

   

4. En el cuadro de búsqueda, escriba Microsoft.CognitiveServices.Speech. Seleccione ese paquete después de que aparezca en los resultados de la búsqueda.

5. En el panel de estado del paquete situado junto a los resultados de la búsqueda, seleccione el proyecto HelloWorld.

6. Seleccione Instalar.

   

7. En el cuadro de diálogo Vista previa de los cambios, seleccione Aceptar.

8. En el cuadro de diálogo Aceptación de licencia, vea la licencia y, a continuación, seleccione Acepto. Comenzará la instalación del paquete. Una vez completada la instalación, el panel Salida muestra un mensaje similar al texto siguiente: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.

Documentación de referencia | Paquete (Go) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para Go.

Requisitos de la plataforma

El SDK de Voz para Go es compatible con las siguientes distribuciones en la arquitectura x64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de Voz depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de hilos POSIX, libpthreads.
• La biblioteca OpenSSL, versión 1.x (libssl1) o 3.x (libssl3), y certificados (ca-certificates).
• La biblioteca compartida para aplicaciones ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Debian 11/12

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

Ejecute estos comandos:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Ejecute estos comandos:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

Instale la versión binaria de Go versión 1.13 o posterior.

Instale el SDK de Voz para Go

Use el procedimiento siguiente para descargar e instalar el SDK. Los pasos incluyen la descarga de las bibliotecas y los archivos de encabezado necesarios, como un archivo .tar.

1. Elija un directorio para los archivos del SDK de Voz. Establezca la variable de entorno SPEECHSDK_ROOT para que apunte a ese directorio. Esta variable facilita la referencia al directorio en futuros comandos.

   Para usar el directorio speechsdk en el directorio principal, ejecute el siguiente comando:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Si no existe el directorio, créelo:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Descargue y extraiga el archivo .tar.gz que contiene los archivos binarios del SDK de voz:

   wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary
   tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
   

4. Valide el contenido del directorio de nivel superior del paquete extraído:

   ls -l "$SPEECHSDK_ROOT"
   

   La lista de directorios debe contener los archivos de licencia y aviso del asociado. La lista debe contener también un directorio include que contenga archivos de encabezado (.h) y un directorio lib que contenga bibliotecas para arm32, arm64, x64 y x86.

   Ruta de acceso	Descripción
   license.md	Licencia
   ThirdPartyNotices.md	Avisos de asociados
   REDIST.txt	Aviso de redistribución
   include	Archivos de encabezado necesarios para C++
   lib/arm32	Biblioteca nativa para ARM32 necesaria para vincular la aplicación
   lib/arm64	Biblioteca nativa para ARM64 necesaria para vincular la aplicación
   lib/x64	Biblioteca nativa para x64 necesaria para vincular la aplicación
   lib/x86	Biblioteca nativa para x86 necesaria para vincular la aplicación

Configuración del entorno de Go

Los pasos siguientes permiten configurar el entorno de Go para buscar el SDK de Voz.

1. Dado que los enlaces se basan en cgo, es necesario que establezca las variables de entorno para que Go pueda encontrar el SDK.

   export CGO_CFLAGS="-I$SPEECHSDK_ROOT/include/c_api"
   export CGO_LDFLAGS="-L$SPEECHSDK_ROOT/lib/<architecture> -lMicrosoft.CognitiveServices.Speech.core"
   

   Importante

   Reemplace <architecture> por la arquitectura de procesador de la CPU: x64, arm32, o arm64.

2. Para ejecutar aplicaciones y el SDK, debe indicar al sistema operativo dónde encontrar las bibliotecas.

   export LD_LIBRARY_PATH="$SPEECHSDK_ROOT/lib/<architecture>:$LD_LIBRARY_PATH"
   

   Importante

   Reemplace <architecture> por la arquitectura de procesador de la CPU: x64, arm32, o arm64.

Documentación de referencia | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para Java.

Requisitos de la plataforma

Elija su ámbito objetivo:

Java Runtime

El SDK de Voz para Java es compatible con Windows, Linux y macOS.

Windows

En Windows debe usar la arquitectura de destino de 64 bits. Se requiere Windows 10 o posterior.

Instale el Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022 para su plataforma. Durante la primera instalación del paquete, es posible que deba reiniciar.

El SDK de Voz para Java no admite Windows en ARM64.

Linux

El SDK de Voz para Java es compatible con las siguientes distribuciones en las arquitecturas x64, ARM32 y ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de Voz depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de hilos POSIX, libpthreads.
• La biblioteca OpenSSL, versión 1.x (libssl1) o 3.x (libssl3), y certificados (ca-certificates).
• La biblioteca compartida para aplicaciones ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Debian 11/12

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

Ejecute estos comandos:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Ejecute estos comandos:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Se requiere una versión de macOS 10.14 o posterior.

Android

El SDK de voz es compatible con dispositivos Android que tengan procesador ARM de 32/64 bits y procesadores Intel x86/x64 compatibles.

Instale un kit de desarrollo de Java como Azul Zulu OpenJDK. La compilación de Microsoft de OpenJDK o su JDK preferido también deberían funcionar.

Instale el SDK de Voz para Java

Algunas de las instrucciones usan una versión específica del SDK, como 1.42.0. Para comprobar la versión más reciente, busque nuestro repositorio de GitHub.

Elija su ámbito objetivo:

Java Runtime

En esta guía se muestra cómo instalar el SDK de Voz para Java en Java Runtime.

Sistemas operativos admitidos

El paquete de SDK de voz para Java está disponible en estos sistemas operativos:

• Windows: solo 64 bits.
• Mac: macOS X 10.14 o posterior.
• Linux: Consulte las distribuciones de Linux y arquitecturas de destino compatibles.

Maven

Siga estos pasos para instalar el SDK de voz para Java mediante Apache Maven:

1. Instalación de Apache Maven.

2. Abra un símbolo del sistema donde desea el nuevo proyecto, y crear un nuevo archivo pom.xml.

3. Copie el siguiente contenido XML en pom.xml:

   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <groupId>com.microsoft.cognitiveservices.speech.samples</groupId>
       <artifactId>quickstart-eclipse</artifactId>
       <version>1.0.0-SNAPSHOT</version>
       <build>
           <sourceDirectory>src</sourceDirectory>
           <plugins>
           <plugin>
               <artifactId>maven-compiler-plugin</artifactId>
               <version>3.7.0</version>
               <configuration>
               <source>1.8</source>
               <target>1.8</target>
               </configuration>
           </plugin>
           </plugins>
       </build>
       <dependencies>
           <dependency>
           <groupId>com.microsoft.cognitiveservices.speech</groupId>
           <artifactId>client-sdk</artifactId>
           <version>1.42.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. Ejecute el siguiente comando de Maven para instalar el SDK de Voz y las dependencias.

   mvn clean dependency:copy-dependencies
   

Eclipse

Creación de un proyecto de Eclipse e instalación del SDK de Voz

1. Instale el IDE de Java de Eclipse. Este IDE requiere que Java ya esté instalado.

2. Inicie Eclipse.

3. En el selector de Eclipse, en el cuadro Área de trabajo, escriba el nombre de un nuevo directorio de área de trabajo. Luego, seleccione Launch (Iniciar).

   

4. Al cabo de unos segundos, aparece la ventana principal del IDE de Eclipse. Cierre la pantalla de bienvenida si hay alguna.

5. En el menú de Eclipse, seleccione Archivo>Nuevo> Proyecto.

6. Aparecerá el cuadro de diálogo Nuevo proyecto. Seleccione Proyecto de Java y, a continuación, seleccione Siguiente.

   

7. Se inicia el asistente para nuevo proyecto de Java. En el campo Nombre del proyecto, escriba quickstart. Elija JavaSE-1.8 como entorno de ejecución. Seleccione Finalizar.

   

8. Si aparece una ventana titulada Open Associated Perspective? (¿Abrir perspectiva asociada?), seleccione Open Perspective (Abrir perspectiva).

9. En el Explorador de paquetes, haga clic en el proyecto quickstart. Seleccione Configurar>Conversión a proyecto Maven en el menú contextual.

   

10. Aparece la ventana Create new POM (Crear nuevo POM). En el campo Identificador de grupo, escriba com.microsoft.cognitiveservices.speech.samples. En el campo Identificador de artefacto, escriba quickstart. Después, seleccione Finalizar.

    

11. Abra el archivo pom.xml y edítelo:

    1. Agregue un dependencies elemento al final del archivo, antes de la etiqueta de cierre </project>, con el SDK de Voz como una dependencia:

    <dependencies>
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.42.0</version>
      </dependency>
    </dependencies>
    

    1. Guarde los cambios.

Gradle

Configuraciones de Gradle

Las configuraciones de Gradle requieren una referencia explícita a la extensión de dependencia .jar:

// build.gradle

dependencies {
    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.42.0", ext: "jar"
}

Android

En esta guía se muestra cómo instalar el SDK de Voz para Java en Android.

El SDK de Voz para Android está empaquetado como un archivo Android Archive (AAR), que incluye las bibliotecas necesarias, así como los permisos necesarios de Android.

Instalación del SDK de Voz mediante Android Studio

Cree un proyecto en Android Studio y agregue el SDK de Voz para Java como dependencia de biblioteca. La configuración se basa en el paquete de Maven de SDK de voz y Android Studio Chipmunk 2021.2.1.

Creación de un proyecto vacío

1. Abra Android Studio y seleccione Proyecto nuevo.

   

2. En la ventana Nuevo proyecto que aparece, seleccione Teléfono y tablet>Actividad vacía y, a continuación, seleccione Siguiente.

   

3. Escriba SpeechQuickstart en el cuadro de texto Nombre.

   

4. En el cuadro de texto de Nombre del paquete, escriba samples.speech.cognitiveservices.microsoft.com.

5. Seleccione un directorio de proyecto en el cuadro de selección Guardar ubicación.

6. Seleccione Java en el cuadro de selección Lenguaje.

7. Seleccione API 23: Android 6.0 (Marshmallow) en el cuadro de selección Nivel mínimo de API.

8. Seleccione Finalizar.

Android Studio tarda algún tiempo en preparar su nuevo proyecto. La primera vez que utilice Android Studio, puede que le lleve unos minutos establecer las preferencias, aceptar las licencias y completar el asistente.

Instale el SDK de Voz para Java en Android

Agregue el SDK de voz como una dependencia en el proyecto.

1. Select Archivo>Estructura del proyecto>Dependencias>aplicación.

2. Seleccione el símbolo más (+) para agregar una dependencia en Dependencias declaradas. A continuación, seleccione Dependencia de la biblioteca en el menú desplegable.

   

3. En la ventana Agregar dependencia de biblioteca que aparece, escriba el nombre y la versión del SDK de Voz para Java: com.microsoft.cognitiveservices.speech:client-sdk:1.42.0. Luego, seleccione Buscar.

4. Asegúrese de que el identificador de grupo seleccionado es com.microsoft.cognitiveservices.speech y, a continuación, seleccione Aceptar.

5. Seleccione OK (Aceptar) para cerrar la ventana de la estructura del proyecto y aplicar los cambios al proyecto.

Documentación de referencia | Paquete (npm) | Ejemplos adicionales en GitHub | Código fuente de la biblioteca

En este inicio rápido, instalará la SDK de voz para JavaScript.

El SDK de Voz para JavaScript está disponible como un paquete npm. Consulte microsoft-cognitiveservices-speech-sdk y la versión complementaria cognitive-services-speech-sdk-js del repositorio de GitHub.

Requisitos de la plataforma

Comprenda las implicaciones arquitectónicas entre Node.js y los exploradores web cliente. Por ejemplo, Document Object Model (DOM) no está disponible para aplicaciones del lado servidor. El sistema de archivos de Node.js no está disponible para las aplicaciones del lado cliente.

Instale el SDK de Voz para JavaScript

En función del entorno de destino, use una de las siguientes guías:

Node.js

En esta guía se muestra cómo instalar el SDK de Voz para JavaScript para su uso con Node.js.

1. Instale Node.js.

2. Cree un nuevo directorio, ejecute npm init y siga las indicaciones.

3. Para instalar el SDK de Voz para JavaScript, ejecute el siguiente comando npm install:

   npm install microsoft-cognitiveservices-speech-sdk
   

Para obtener más información, consulte los ejemplos deNode.js.

Basado en explorador

En esta guía se muestra cómo instalar el SDK de Voz para JavaScript para su uso con una página web.

Desempaquetar en una carpeta

1. Cree una nueva carpeta vacía. Si desea hospedar el ejemplo en un servidor web, asegúrese de que este puede acceder a la carpeta.

2. Descargue el SDK de Voz en forma de paquete .zip y desempaquételo en la carpeta recién creada. Estos archivos se descomprimen:

   • microsoft.cognitiveservices.speech.sdk.bundle.js: una versión legible del SDK de Voz.
   • microsoft.cognitiveservices.speech.sdk.bundle.js.map: un archivo de asignación que se usa para depurar el código del SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.d.ts: definiciones de objeto para su uso con TypeScript.
   • microsoft.cognitiveservices.speech.sdk.bundle-min.js: una versión reducida del SDK de Voz.
   • speech-processor.js: código para mejorar el rendimiento en algunos exploradores.

3. Cree un nuevo archivo en la carpeta llamado index.html y ábralo con un editor de texto.

Etiqueta de script HTML

Descargue y extraiga el archivo microsoft.cognitiveservices.speech.sdk.bundle.js del SDK de voz para JavaScript. Colóquelo en una carpeta a la que pueda acceder el archivo HTML.

<script src="microsoft.cognitiveservices.speech.sdk.bundle.js"></script>;

Sugerencia

Si el destino es un explorador web y se usa la etiqueta <script>, el prefijo sdk no es necesario. El prefijo sdk es un alias que se usa para asignar un nombre al módulo require.

Como alternativa, puede incluir directamente una etiqueta <script> en el elemento HTML <head>, basándose en la JSDelivr.

<script src="https://cdn.jsdelivr.net/npm/microsoft-cognitiveservices-speech-sdk@latest/distrib/browser/microsoft.cognitiveservices.speech.sdk.bundle-min.js">
</script>

Para obtener más información, consulte los ejemplos basados en explorador.

Uso del SDK de Voz

• Agregue la siguiente instrucción import para usar el SDK de voz en el proyecto de JavaScript:

  import * as sdk from "microsoft-cognitiveservices-speech-sdk";
  

Para más información sobre import, consulte Exportación e importación en el sitio web de JavaScript.

Como alternativa, puede usar una instrucción require:

const sdk = require("microsoft-cognitiveservices-speech-sdk");

Documentación de referencia | Paquete (descarga) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para Objective-C.

Sugerencia

Para obtener más información sobre el uso del SDK de voz para Swift, consulte Importación de Objective-C en Swift.

Instale el SDK de Voz para Objective-C

Mac

El SDK de voz para Objective-C está disponible de forma nativa como paquete CocoaPod para Mac x64 y sistemas basados en ARM.

Requisitos del sistema para Mac:

• macOS 10.14, o cualquier versión posterior

El paquete CocoaPod de macOS está disponible para descargarlo y usarlo con el entorno de desarrollo integrado (IDE) Xcode 9.4.1 o posterior.

1. Vaya al directorio Xcode donde se encuentra el archivo del proyecto .xcodeproj.

2. Ejecute pod init para crear un archivo de pod denominado Podfile.

3. Reemplace el contenido de Podfile por el siguiente contenido. Actualice el nombre target de AppName al nombre de la aplicación. Actualice la versión de la plataforma o del pod según sea necesario.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.42.0'
   end
   

4. Ejecute pod install para instalar el SDK de voz.

Como alternativa, descargue el CocoaPod binario y extraiga su contenido. En el proyecto de Xcode, agregue una referencia a la carpeta extraída MicrosoftCognitiveServicesSpeech.xcframework y su contenido.

Nota:

Los desarrolladores de .NET pueden compilar aplicaciones nativas de macOS mediante el marco de trabajo de la aplicación de Xamarin.Mac. Para más información, consulte Xamarin.Mac.

iOS

El SDK de voz para Objective-C está disponible de forma nativa como paquete CocoaPod.

Requisitos del sistema para iOS:

• macOS 10.14, o cualquier versión posterior
• iOS de destino 9.3 o posterior

El paquete CocoaPod de macOS está disponible para descargarlo y usarlo con el entorno de desarrollo integrado (IDE) Xcode 9.4.1 o posterior.

1. Vaya al directorio Xcode donde se encuentra el archivo del proyecto .xcodeproj.

2. Ejecute pod init para crear un archivo de pod denominado Podfile.

3. Reemplace el contenido de Podfile por el siguiente contenido. Actualice el nombre target de AppName al nombre de la aplicación. Actualice la versión de la plataforma o del pod según sea necesario.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.42.0'
   end
   

4. Ejecute pod install para instalar el SDK de voz.

Como alternativa, descargue el CocoaPod binario y extraiga su contenido. En el proyecto de Xcode, agregue una referencia a la carpeta extraída MicrosoftCognitiveServicesSpeech.xcframework y su contenido.

Nota:

Los desarrolladores de .NET pueden compilar aplicaciones nativas de iOS mediante el marco de trabajo de la aplicación de Xamarin.iOS. Para obtener más información, consulte Xamarin.iOS.

Documentación de referencia | Paquete (descarga) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para Swift.

Sugerencia

Para obtener más información sobre el uso del SDK de voz para Swift, consulte Importación de Objective-C en Swift.

Instale el SDK de Voz para Swift

Mac

El SDK de voz para Swift está disponible de forma nativa como paquete CocoaPod para sistemas Mac basados en x64 y ARM.

Requisitos del sistema para Mac:

• macOS 10.14, o cualquier versión posterior

El paquete CocoaPod de macOS está disponible para descargarlo y usarlo con el entorno de desarrollo integrado (IDE) Xcode 9.4.1 o posterior.

1. Vaya al directorio Xcode donde se encuentra el archivo del proyecto .xcodeproj.

2. Ejecute pod init para crear un archivo de pod denominado Podfile.

3. Reemplace el contenido de Podfile por el siguiente contenido. Actualice el nombre target de AppName al nombre de la aplicación. Actualice la versión de la plataforma o del pod según sea necesario.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.42.0'
   end
   

4. Ejecute pod install para instalar el SDK de voz.

Como alternativa, descargue el CocoaPod binario y extraiga su contenido. En el proyecto de Xcode, agregue una referencia a la carpeta extraída MicrosoftCognitiveServicesSpeech.xcframework y su contenido.

Nota:

Los desarrolladores de .NET pueden compilar aplicaciones nativas de macOS mediante el marco de trabajo de la aplicación de Xamarin.Mac. Para más información, consulte Xamarin.Mac.

iOS

El SDK de voz para Swift está disponible de forma nativa como paquete CocoaPod.

Requisitos del sistema para iOS:

• macOS 10.14, o cualquier versión posterior
• iOS de destino 9.3 o posterior

El paquete CocoaPod de macOS está disponible para descargarlo y usarlo con el entorno de desarrollo integrado (IDE) Xcode 9.4.1 o posterior.

1. Vaya al directorio Xcode donde se encuentra el archivo del proyecto .xcodeproj.

2. Ejecute pod init para crear un archivo de pod denominado Podfile.

3. Reemplace el contenido de Podfile por lo siguiente. Actualice el nombre target de AppName al nombre de la aplicación. Actualice la versión de la plataforma o del pod según sea necesario.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.42.0'
   end
   

4. Ejecute pod install para instalar el SDK de voz.

Como alternativa, descargue el CocoaPod binario y extraiga su contenido. En el proyecto de Xcode, agregue una referencia a la carpeta extraída MicrosoftCognitiveServicesSpeech.xcframework y su contenido.

Nota:

Los desarrolladores de .NET pueden compilar aplicaciones nativas de iOS mediante el marco de trabajo de la aplicación de Xamarin.iOS. Para obtener más información, consulte Xamarin.iOS.

Documentación de referencia | Paquete (PyPi) | Ejemplos adicionales en GitHub

En este inicio rápido, instalará la SDK de voz para Python.

Requisitos de la plataforma

El SDK de Voz para Python es compatible con Windows, Linux y macOS.

Windows

En Windows debe usar la arquitectura de destino de 64 bits. Se requiere Windows 10 o posterior.

Instale el Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022 para su plataforma. Durante la primera instalación del paquete, es posible que deba reiniciar.

Importante

Asegúrese de que están instalados los paquetes de la misma arquitectura de destino. Por ejemplo, si instala el paquete redistribuible x64, instale el paquete de Python x64.

Linux

El SDK de voz para Python es compatible con las siguientes distribuciones en las arquitecturas x64 y ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de Voz depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de hilos POSIX, libpthreads.
• La biblioteca OpenSSL, versión 1.x (libssl1) o 3.x (libssl3), y certificados (ca-certificates).
• La biblioteca compartida para aplicaciones ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Debian 11/12

Ejecute estos comandos:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

Ejecute estos comandos:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Ejecute estos comandos:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Se requiere una versión de macOS 10.14 o posterior.

Instale una versión de Python desde la 3.8 en adelante.

• Para comprobar la instalación, abra un terminal y ejecute el comando python --version. Si Python se instala correctamente, obtiene una respuesta como Python 3.8.10.

• Si usa macOS o Linux, es posible que tenga que ejecutar el comando python3 --version en su lugar.

  Para habilitar el uso de python, en lugar de python3, ejecute alias python='python3' para configurar un alias. Los ejemplos de inicio rápido del SDK de Voz especifican el uso de python.

Instale el SDK de Voz para Python

Antes de instalar el SDK de voz para Python, asegúrese de satisfacer los requisitos de la plataforma.

PyPI

Instalar desde PyPI

Para instalar el SDK de voz para Python, ejecute este comando en una ventana de consola:

pip install azure-cognitiveservices-speech

Actualice a la última versión del SDK de voz

Para actualizar al SDK de voz más reciente, ejecute este comando en una ventana de consola:

pip install --upgrade azure-cognitiveservices-speech

Puede comprobar qué versión del SDK de voz para Python está instalada actualmente mediante la inspección de la variable azure.cognitiveservices.speech.__version__. Por ejemplo, ejecute este comando en una ventana de consola:

pip list

Código de VS

Instalación del SDK de Voz mediante Visual Studio Code

Para instalar el SDK de voz para Python:

1. Descargue e instale Visual Studio Code.

2. Ejecute Visual Studio Code e instale la extensión de Python:

   1. Seleccione Archivo>Preferencias>Extensiones.
   2. Busque Python, busque la extensión de Python para Visual Studio Code publicada por Microsoft, y luego seleccione Install (Instalar).

   

3. Seleccione Terminal(Termoinal)>New Terminal(Nueva Terminal) para abrir una terminal dentro de Visual Studio Code.

4. En el indicador del terminal, ejecute el siguiente comando para instalar el paquete del SDK de voz para Python.

   python -m pip install azure-cognitiveservices-speech
   

Para obtener más información sobre Visual Studio Code y Python, consulte Visual Studio Code e Introducción a Python en VS Code.

Uso del SDK de Voz

Agregue la siguiente instrucción import para usar el SDK de voz en el proyecto de Python:

import azure.cognitiveservices.speech as speechsdk

Contenido relacionado

• Inicio rápido de voz a texto
• Inicio rápido para la conversión de texto a voz
• Inicio rápido sobre la traducción de voz