La API de Recording & Playback te permite grabar una sesión y usarla en lugar del feed de la cámara en tiempo real. Sin embargo, esos registros solo contienen datos de video y de sensores. También puedes agregar datos personalizados a una grabación de sesión y hacer que se muestren los datos durante la reproducción, como si fueran parte de una imagen de la cámara.
ARCore no incluye automáticamente ningún dato personalizado en las grabaciones. En cambio, te permite agregar datos personalizados a un fotograma de ARCore durante la grabación y recuperar esos datos del fotograma durante la reproducción. Depende de ti programar la app para que el usuario recupere los datos que espera cuando reproduzca su sesión.
Casos de uso de datos personalizados
Agregar datos personalizados a las grabaciones amplía las posibilidades de tus apps de RA. Estos son algunos casos de uso específicos.
Usa la RA estés donde estés
Antes, los usuarios solo podían acceder a experiencias de RA en el lugar y el momento adecuados. Si quisieran colocar una lámpara de RA en la sala de estar, tenían que estar físicamente parados en el lugar para ver cómo se vería allí. Con las pistas personalizadas, pueden grabar su sala de estar una sola vez y agregar muebles virtuales a la escena cuando lo deseen.
Crea experiencias de RA en conjunto
Sin un requisito de una sesión en vivo, los usuarios tienen muchas más opciones de edición de RA, lo que les permite crear contenido único de RA y acceder a él en cualquier lugar y momento. Por ejemplo, pueden grabar un entorno determinado, agregar efectos de realidad aumentada y compartirlos con amigos.
Requisitos previos
Asegúrate de comprender los conceptos fundamentales de RA y cómo configurar una sesión de ARCore antes de continuar.
Cómo registrar con datos personalizados
Crea una grabación de la sesión con datos personalizados.
Cómo inicializar una grabación con datos personalizados
Sigue estos pasos para inicializar un registro con datos personalizados. Para iniciar, detener y revisar una sesión de grabación, consulta Cómo grabar y reproducir sesiones de RA.
- Obtén un
ArRecordingConfig
. - Crea una
ArTrack
nueva con un UUID personalizado. Todos los datos personalizados se guardarán aquí. - Agrega el
ArTrack
alArRecordingConfig
que creaste durante la configuración de la sesión.
// Initialize a new track with a custom UUID. // Make sure to save the UUID because it is the ID that you will use to get // your data back during playback. ArTrack* track = NULL; ArTrack_create(ar_session, &track); // String from UUID generator: de5ec7a4-09ec-4c48-b2c3-a98b66e71893 uint8_t uuid_byte_array[16] = {0xde, 0x5e, 0xc7, 0xa4, 0x09, 0xec, 0x4c, 0x48, 0xb2, 0xc3, 0xa9, 0x8b, 0x66, 0xe7, 0x18, 0x93}; ArTrack_setId(ar_session, track, uuid_byte_array); // Add the ArTrack to the recording_config. // recording_config must already be configured. ArRecordingConfig_addTrack(ar_session, recording_config, track); ArTrack_destroy(track);
Todas las pistas nuevas se consideran grabaciones separadas, y cada pista grabada ocupa su propio UUID.
Opcional: Configura el segmento con datos adicionales
En caso de que quieras identificarla más adelante, puedes configurar una pista con datos adicionales que describa la grabación de la sesión. Por ejemplo, puedes "etiquetar" una pista agregando una nota que describa la ubicación y la hora en las que grabaste la sesión: "Esta sesión se grabó en el centro comercial a la tarde".
// Set additional data on this track. // For example, describe where you recorded the session. uint8_t metadata_size = 4; uint8_t metadata[5] = "HOME"; ArTrack_setMetadata(ar_session, track, metadata, metadata_size);
Opcional: Configura la pista con un tipo de MIME
Si tu app necesita ser compatible con herramientas externas, puedes configurar un segmento con un tipo de MIME que describa el tipo de datos registrados en el segmento. Si no especificas un tipo, los datos se categorizarán como application/text
. ARCore ignora el tipo de MIME cuando lee datos.
// Set a MIME type for compatibility with external tools. ArTrack_setMimeType(ar_session, track, "text/csv");
Graba seguimientos de datos personalizados
Todos los datos de pistas personalizadas se registran en ArFrame
. Las sesiones de RA usan ArSession_update()
para obtener un fotograma. El momento en que registras datos en un fotograma es el mismo momento en el que se devuelven los datos durante la reproducción. Por ejemplo, si llamas a ArFrame_recordTrackData()
con el valor "A" en 00:07:02
, obtendrás "A" en la marca 00:07:02
cuando se reproduzca la pista.
Para grabar un seguimiento de datos personalizado, llama a ArFrame_recordTrackData()
.
// Place an AR lamp in a room. if (place_lamp_button_was_pressed) { uint8_t lamp_data[1] = {lamp_id}; ArFrame_recordTrackData(ar_session, frame, uuid_byte_array, lamp_data, /*payload_size=*/1); }
Cómo reproducir pistas de datos personalizadas
Extrae datos personalizados de una grabación de sesión durante la reproducción.
Cómo inicializar una reproducción
Inicializar una reproducción con datos personalizados es lo mismo que inicializar la reproducción de una grabación de una sesión normal.
Muestra datos personalizados
Llama a ArFrame_getUpdatedTrackData()
para recuperar los datos personalizados registrados en un ArFrame
. Es posible recuperar varios datos de seguimiento del mismo fotograma. Por ejemplo, si llamaste a ArFrame_recordTrackData()
dos veces en el mismo fotograma durante la grabación, obtendrás dos instancias de ArTrackData
durante la reproducción.
// Create the container to hold the track data retrieved from the frame. ArTrackDataList* fetched_track_data_list; ArTrackDataList_create(ar_session, &fetched_track_data_list); // Fetch the track data from the frame into the created container. ArFrame_getUpdatedTrackData(ar_session, frame, uuid_byte_array, fetched_track_data_list);
Una vez que ArTrackData
esté en un objeto de contenedor, extrae los bytes de datos personalizados.
// Fetch the size of the track data list. int32_t fetched_track_data_list_size; ArTrackDataList_getSize(ar_session, fetched_track_data_list, &fetched_track_data_list_size); // Iterate through the list. for (int i = 0; i < fetched_track_data_list_size; i++) { ArTrackData* fetched_track_data; ArTrackDataList_acquireItem(ar_session, fetched_track_data_list, i, &fetched_track_data); // Process "fetched_track_data->sample" as desired ArTrackData_release(fetched_track_data); } ArTrackDataList_destroy(fetched_track_data_list);
¿Qué sigue?
- Para aprender a compilar tu propia app con las funciones de grabación y reproducción, consulta el codelab de grabación y reproducción.