Se usó la API de Cloud Translation para traducir esta página.

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.
Bazel 7.4.1
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

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

Consola de Google Cloud

En la consola de Google Cloud, habilita la API de REST de Meet.

Habilitar las API
Confirma que habilitarás la API de REST de Meet en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.
Confirma que habilitarás la API de REST de Meet y, luego, haz clic en Habilitar.

gcloud CLI

Si es necesario, establece el proyecto de Cloud actual en el que creaste:
```
gcloud config set project PROJECT_ID
```
Reemplaza PROJECT_ID por el ID del proyecto del proyecto de Cloud que creaste.

Habilita la API de REST de Meet:

gcloud services enable meet.googleapis.com

Compila el cliente de C++

La implementación en C++ se compila con Bazel. Sin embargo, la biblioteca de WebRTC en C++ (libwebrtc) no tiene una compilación de Bazel que funcione, por lo que primero debes compilar esa biblioteca siguiendo las instrucciones de la documentación de WebRTC.

A continuación, se muestra una versión abreviada de lo que se explica en la documentación de WebRTC:
```
$ cd ~
$ mkdir src
$ cd src
$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
$ export PATH=~/src/depot_tools:$PATH
$ mkdir webrtc-checkout
$ cd webrtc-checkout
$ fetch --nohooks webrtc
$ cd src
$ # Latest known version to work with our builds
$ git checkout b00c469cad3f8c926fcf81ded90b90b6e1e62b9c
$ cd ..
$ gclient sync
$ mv src webrtc
$ cd webrtc
$ ./build/install-build-deps.sh
$ gn gen out/Default --args='is_debug=false use_custom_libcxx=false rtc_include_tests=false rtc_build_examples=false dcheck_always_on=true rtc_use_x11=false use_rtti=true'
$ ninja -C out/Default
```
Nota: La confirmación b00c469cad3f8c926fcf81ded90b90b6e1e62b9c es la versión más reciente conocida que funciona con nuestras compilaciones debido a las actualizaciones de la cadena de herramientas y de Abseil. Esto podría cambiar en el futuro. Este conjunto de comandos ahora funciona, pero se debe consultar el vínculo proporcionado en caso de que cambien las herramientas subyacentes. Si compilas para una variante de Linux de Debian o Ubuntu que no sea x64, es posible que la configuración de los requisitos previos sea diferente.
Después de compilar libwebrtc, actualiza tu archivo WORKSPACE para que apunte a tu directorio webrtc-checkout. Actualiza la ruta de acceso webrtc_path cerca de la parte superior de ese archivo:
```
webrtc_path = "/usr/local/myuser/webrtc-checkout/" 
```
Usa Bazel para compilar el cliente de C++:
```
$ bazel build //cpp/...
```

Nota: Debes usar Bazel 7.4.1. Si tienes instaladas versiones más recientes de Bazel, puedes ejecutarlo con bazel-7.4.1 build/run/test ....

De manera opcional, ejecuta las pruebas:
```
$ bazel test //cpp/...
```

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.

Muestra de medios 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:

Linux

$ bazel run cpp/samples:single_user_media_sample -- \
    --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:

Linux y Mac

# 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:

Opción	Descripción
`--output_file_prefix PREFIX`	Especifica el prefijo para los archivos de salida. La configuración predeterminada es `/tmp_test_output_`.
`--collection_duration DURATION`	Especifica cuánto tiempo se recopilarán los medios. La configuración predeterminada es `30s`.
`--join_timeout TIMEOUT`	Especifica cuánto tiempo esperar a que la app se una a la conferencia. La configuración predeterminada es `2m`.
`--meet_api_url URL`	Especifica la URL de la API de Meet Media. La configuración predeterminada es `https://meet.googleapis.com/v2alpha/`.