هنگام ضبط در AR Foundation که Android را هدف قرار می دهد، داده های سفارشی اضافه کنید

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

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

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

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

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

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

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

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

پیش نیازها

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

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

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

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

// 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.
var track = new Track {
 Id = Guid.Parse("de5ec7a4-09ec-4c48-b2c3-a98b66e71893") // from UUID generator
};

// Add the Track to the recordingConfig.
// recordingConfig must already be configured.
List<Track> tracks = new List<Track>();
tracks.Add(track);
recordingConfig.Tracks = tracks;

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

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

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

// Set additional data on this track.
// For example, describe where you recorded the session.
byte[] metadata = ...
track.Metadata = metadata;

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

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

اگر یک نوع را مشخص نکنید، داده ها به عنوان application/text دسته بندی می شوند. ARCore هنگام خواندن داده ها، نوع MIME را نادیده می گیرد.

// Set a MIME type for compatibility with external tools.
track.MimeType = "text/csv";

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

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

برای ضبط یک مسیر داده سفارشی، RecordTrackData() را فراخوانی کنید.

// Place an AR lamp in a room.
if (placeLampButtonWasPressed) {
  // Convert the lamp data into a byte array.
  var lampData = new byte[] { (byte) Lamp.FLOOR };  // a floor lamp
  recordingManager.RecordTrackData(trackGuid, lampData);
}

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

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

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

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

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

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

// Fetch the data recorded on a select frame and place it in a
// container object.
var trackDataList = recordingManager.GetUpdatedTrackData(trackGuid);

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

// Extract the bytes of custom data from the list of track data.
foreach (TrackData trackData in trackDataList) {
  var data = trackData.Data;
  Lamp lamp = Lamp.fromByte(data[0]); // This is the lamp!
}

بعدش چی

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