API de Meet Media: Guía de inicio rápido del cliente de referencia de C++

En esta página, se explica cómo configurar y ejecutar una muestra con la implementación del cliente de referencia en C++. Para obtener información sobre el cliente de TypeScript, consulta la guía de inicio rápido del cliente de referencia de TypeScript.

Requisitos previos

Para ejecutar esta guía de inicio rápido, necesitas cumplir con los siguientes requisitos previos:

• Clonaste el repositorio de GitHub.
• Un proyecto de Google Cloud con la API de REST de Google Meet habilitada
• Una cuenta de Google Workspace

Habilita la API de REST de Meet

Compila el cliente de C++

La implementación de C++ se compila con Generate Ninja (GN). Para obtener más información, consulta la documentación de WebRTC.

1. Genera una contraseña desde Git en Google y configura Git.

2. Desde tu interfaz de línea de comandos (CLI), cambia <samples_location> al directorio que contiene las muestras y ejecuta el siguiente comando, que hace lo siguiente:

   • Cambia tu directorio de trabajo a tu directorio principal.
   • Crea un directorio en tu directorio principal llamado src.
   • Cambia tu directorio de trabajo a src.
   • Clona https://chromium.googlesource.com/chromium/tools/depot_tools.git en el directorio src/ desde git.
   • Agrega temporalmente el directorio ~/src/depot_tools a la lista de ubicaciones en las que la shell busca comandos ejecutables.
   • Cambia tu directorio de trabajo al directorio cpp en la ubicación de tus muestras.
   • Ejecuta la secuencia de comandos de shell ./build.sh.

   cd ~
   mkdir src
   cd src
   git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
   export PATH=~/src/depot_tools:$PATH
   cd <samples_location>/cpp
   sh ./build.sh

Genera tokens de OAuth

Para conectarse a la API de Meet Media, tu app debe usar OAuth para generar tokens de acceso. Para obtener más información sobre cómo acceder a las APIs de Google con OAuth, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Puedes usar OAuth 2.0 Playground para generar tokens. Cuando uses la zona de pruebas, asegúrate de hacer lo siguiente:

• Usa las credenciales de ID y secreto del cliente de tu proyecto de Cloud.
• Solicita los alcances correctos.
• Accede a una Cuenta de Google y acepta el acceso.

Cuando termines, haz clic en el botón Exchange authorization code for tokens y copia el token de acceso generado.

Cómo iniciar una reunión

Inicia una reunión con la misma cuenta de usuario que usaste para generar el token de OAuth. Copia el código de la reunión. Ya puedes ejecutar las muestras.

Apps de ejemplo

El repositorio de GitHub ofrece muestras para recibir metadatos de participantes y contenido multimedia de una reunión.

Estas muestras recopilan datos durante un período especificado (el valor predeterminado es de 3 segundos) y escriben los datos recopilados en archivos.

Los archivos de audio están en formato PCM16. Los archivos de video están en formato YUV420p. Estos archivos se pueden reproducir con una biblioteca como FFmpeg.

Dado que las resoluciones de video pueden cambiar durante una reunión, las muestras incluyen la resolución en los nombres de los archivos de video.

Los archivos de metadatos de los participantes serán archivos de texto legibles por humanos.

Ejemplo de contenido multimedia de un solo usuario

La muestra de medios de un solo usuario es una app básica que se enfoca en recopilar audio y video. La muestra no determina qué participante creó los datos de audio y video. Por lo tanto, usar esta muestra en una reunión con más de un participante podría generar una salida dañada.

Para ejecutar la muestra de medios de un solo usuario, ejecuta el siguiente comando:

$ sh ./run_multi.sh -- \
    --meeting_space_id MEETING_SPACE_ID \
    --oauth_token OAUTH_TOKEN

De forma predeterminada, se guarda un solo archivo de audio en /tmp/test_output_audio.pcm.

Debido a que los flujos de video pueden cambiar de resolución durante una reunión, es posible que se creen varios archivos de video. Los nombres de los archivos de video incluirán un contador incremental y la resolución de ese archivo. Por ejemplo, si la resolución de la transmisión de video cambió de 320 x 180 a 240 x 135 y, luego, volvió a 320 x 180, se crearían los siguientes archivos de video:

• /tmp/test_output_video_0_320x180.pcm
• /tmp/test_output_video_1_240x135.pcm
• /tmp/test_output_video_2_320x180.pcm

(Opcional) Usa FFmpeg para reproducir archivos de salida en Linux y Mac

FFmpeg se puede usar para reproducir archivos de audio y video creados. Comandos de ejemplo:

# Audio
$ ffplay -f s16le -ar 48k -af aformat=channel_layouts=mono \
    /tmp/test_output_audio.pcm

# Video
#
# `video_size` must match the resolution in the video filename (320x180 in
# this example).
$ ffplay -f rawvideo -pixel_format yuv420p -video_size 320x180 \
    /tmp/test_output_video_0_320x180.yuv

Opciones

Puedes especificar estas opciones cuando ejecutes las muestras:

Temas relacionados

• Soluciona problemas y corrige errores de la API de Meet Media

• Referencia de los canales de datos de la API de Meet Media