داده های سفارشی را هنگام ضبط در Android NDK اضافه کنید

Recording & Playback API به شما امکان می دهد یک جلسه را ضبط کنید و از آن به جای یک فید دوربین بیدرنگ استفاده کنید. با این حال، این ضبط‌ها فقط حاوی داده‌های ویدئویی و حسگر هستند. همچنین می‌توانید داده‌های سفارشی را به ضبط جلسه اضافه کنید و داده‌ها را در حین پخش به شما بازگردانید، گویی بخشی از یک تصویر دوربین است.

ARCore به طور خودکار هیچ داده سفارشی را در ضبط ها شامل نمی شود. در عوض، به شما امکان می دهد تا داده های سفارشی را در حین ضبط به یک فریم ARCore اضافه کنید و همان داده ها را در حین پخش از فریم بازیابی کنید. این به شما بستگی دارد که برنامه را به گونه ای برنامه ریزی کنید که کاربر هنگام پخش جلسه خود، داده های مورد انتظار خود را پس بگیرد.

از موارد برای داده های سفارشی استفاده کنید

افزودن داده‌های سفارشی به ضبط‌ها، امکانات برنامه‌های AR شما را افزایش می‌دهد. موارد زیر چند مورد استفاده خاص است.

از AR در حال حرکت استفاده کنید

در گذشته، کاربران فقط می توانستند در مکان و زمان مناسب به تجربیات AR دسترسی داشته باشند. اگر آنها می خواستند یک لامپ AR در اتاق نشیمن خود قرار دهند، باید به صورت فیزیکی در محل بایستند تا ببینند لامپ در آنجا چگونه به نظر می رسد. با استفاده از آهنگ های سفارشی، آنها می توانند یک بار اتاق نشیمن خود را ضبط کنند و هر زمان که دوست داشتند مبلمان مجازی را به صحنه اضافه کنند.

تجربیات AR را به صورت مشترک ایجاد کنید

بدون نیاز به جلسه زنده، کاربران گزینه های بیشتری برای ویرایش واقعیت افزوده دارند که به آنها امکان می دهد محتوای AR منحصر به فرد را در هر مکان و زمانی ایجاد کنند و به آن دسترسی داشته باشند. به عنوان مثال، آنها می توانند یک محیط معین را ضبط کنند، جلوه های واقعیت افزوده را اضافه کنند و آنها را با دوستان خود به اشتراک بگذارند.

پیش نیازها

قبل از ادامه، مطمئن شوید که مفاهیم اساسی AR و نحوه پیکربندی یک جلسه ARCore را درک کرده اید.

با داده های سفارشی ضبط کنید

یک جلسه ضبط شده با داده های سفارشی ایجاد کنید.

یک ضبط را با داده های سفارشی راه اندازی کنید

این مراحل را برای مقداردهی اولیه یک ضبط با داده های سفارشی دنبال کنید. برای شروع، توقف و بررسی جلسه ضبط، لطفاً به ضبط و پخش یک جلسه AR مراجعه کنید.

ArRecordingConfig را دریافت کنید.
یک ArTrack جدید با یک UUID سفارشی ایجاد کنید. تمام داده های سفارشی در اینجا ذخیره می شود.
ArTrack به ArRecordingConfig که در طول پیکربندی جلسه ایجاد کردید اضافه کنید.

// 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);

همه آهنگ‌های جدید به‌عنوان ضبط‌های جداگانه در نظر گرفته می‌شوند و هر آهنگ ضبط‌شده UUID خاص خود را اشغال می‌کند.

اختیاری: مسیر را با داده های اضافی پیکربندی کنید

در صورتی که می‌خواهید بعداً آن را شناسایی کنید، می‌توانید آهنگی را با داده‌های اضافی که ضبط جلسه را توصیف می‌کند، پیکربندی کنید. برای مثال، می‌توانید با افزودن یادداشتی که مکان و زمان ضبط جلسه را توضیح می‌دهد، یک آهنگ را «تگ» کنید: «این جلسه بعد از ظهر در مرکز خرید ضبط شد».

// 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);

اختیاری: آهنگ را با نوع MIME پیکربندی کنید

اگر برنامه شما باید با ابزارهای خارجی سازگار باشد، می‌توانید آهنگی را با نوع MIME پیکربندی کنید که نوع داده‌های ضبط‌شده در مسیر را توصیف می‌کند. اگر یک نوع را مشخص نکنید، داده ها به عنوان application/text دسته بندی می شوند. ARCore هنگام خواندن داده ها، نوع MIME را نادیده می گیرد.

// Set a MIME type for compatibility with external tools.
ArTrack_setMimeType(ar_session, track, "text/csv");

آهنگ های داده سفارشی را ضبط کنید

تمام داده های آهنگ سفارشی بر روی ArFrame s ثبت می شود. جلسات AR از ArSession_update() برای دریافت فریم استفاده می کنند. زمانی که داده ها را روی یک فریم ضبط می کنید، همان زمانی است که داده ها در حین پخش بازگردانده می شوند. برای مثال، اگر ArFrame_recordTrackData() را با مقدار "A" در 00:07:02 فراخوانی کنید، هنگام پخش آهنگ، "A" را در علامت 00:07:02 دریافت خواهید کرد.

برای ضبط یک مسیر داده سفارشی، 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);
}

آهنگ های داده سفارشی را پخش کنید

استخراج داده های سفارشی از ضبط جلسه در حین پخش.

پخش را آغاز کنید

راه‌اندازی پخش با داده‌های سفارشی مانند راه‌اندازی پخش یک ضبط معمولی جلسه است.

داده های سفارشی را برگردانید

برای بازیابی داده های سفارشی ثبت شده در یک ArFrame ArFrame_getUpdatedTrackData() فراخوانی کنید. امکان بازیابی داده های چند آهنگ از یک فریم وجود دارد. به عنوان مثال، اگر در حین ضبط دو بار ArFrame_recordTrackData() روی یک فریم فراخوانی کنید، در حین پخش دو نمونه از ArTrackData را دریافت خواهید کرد.

// 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);

هنگامی که ArTrackData در یک شی کانتینر قرار گرفت، بایت های داده سفارشی را استخراج کنید.

// 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);

بعدش چی

با مراجعه به نوار کد ضبط و پخش، نحوه ساخت برنامه خود را با ضبط و پخش بیاموزید.