Android NDK पर रिकॉर्डिंग करते समय कस्टम डेटा जोड़ना

द रिकॉर्डिंग ऐंड 'प्लेबैक एपीआई' की मदद से, किसी सेशन को रिकॉर्ड किया जा सकता है और उसका इस्तेमाल रीयल-टाइम कैमरा फ़ीड की जगह किया जा सकता है. हालांकि, इन रिकॉर्डिंग में सिर्फ़ वीडियो और सेंसर डेटा होता है. किसी सेशन की रिकॉर्डिंग में कस्टम डेटा भी जोड़ा जा सकता है और वीडियो चलाने के दौरान वह आपको वापस मिल सकता है. यह इस तरह से काम करता है जैसे यह किसी कैमरे का हिस्सा हो.

ARCore, रिकॉर्डिंग में कोई भी कस्टम डेटा अपने-आप शामिल नहीं करता. इसके बजाय, इससे रिकॉर्डिंग के दौरान आपको ARCore फ़्रेम में पसंद के मुताबिक डेटा जोड़ने की सुविधा मिलती है और रिकॉर्डिंग के दौरान उसी डेटा को फ़्रेम से वापस लाया जा सकता है. यह आप पर निर्भर करता है कि ऐप्लिकेशन को इस तरह प्रोग्राम किया जाए कि उपयोगकर्ता को अपना सेशन चलाने के दौरान, उम्मीद के मुताबिक डेटा वापस मिल जाए.

कस्टम डेटा के लिए इस्तेमाल के उदाहरण

रिकॉर्डिंग में कस्टम डेटा जोड़ने से, एआर ऐप्लिकेशन का इस्तेमाल करना ज़्यादा आसान हो जाता है. नीचे कुछ खास इस्तेमाल के उदाहरण दिए गए हैं.

कभी भी, कहीं भी एआर (ऑगमेंटेड रिएलिटी) का इस्तेमाल करें

पहले लोग एआर (ऑगमेंटेड रिएलिटी) की सुविधाओं को सिर्फ़ सही जगह और सही समय पर ऐक्सेस कर सकते थे. अगर उन्हें अपने लिविंग रूम में एआर लैंप लगाना है, तो उन्हें उस जगह पर खुद जाकर देखना होगा कि लैंप वहां कैसा दिखेगा. कस्टम ट्रैक की मदद से, वे अपने लिविंग रूम को रिकॉर्ड कर सकते हैं और जब चाहें, इसमें वर्चुअल फ़र्नीचर जोड़ सकते हैं.

साथ मिलकर एआर का अनुभव लें

लाइव सेशन की ज़रूरत न होने पर, उपयोगकर्ताओं के पास एआर (ऑगमेंटेड रिएलिटी) में बदलाव करने के कई विकल्प होते हैं. इनकी मदद से, वे किसी भी जगह और समय पर यूनीक एआर कॉन्टेंट बना सकते हैं और उसे ऐक्सेस कर सकते हैं. उदाहरण के लिए, बच्चे किसी डिवाइस पर मौजूद माहौल को रिकॉर्ड कर सकते हैं, उसमें ऑगमेंटेड रिएलिटी (एआर) इफ़ेक्ट जोड़ सकते हैं, और उसे अपने दोस्तों के साथ शेयर कर सकते हैं.

ज़रूरी शर्तें

पक्का करें कि आपको एआर के बुनियादी सिद्धांतों के बारे में पता हो साथ ही, आगे बढ़ने से पहले ARCore सेशन को कॉन्फ़िगर करने का तरीका जानें.

कस्टम डेटा की मदद से रिकॉर्ड करें

कस्टम डेटा के साथ सेशन रिकॉर्डिंग बनाएं.

कस्टम डेटा के साथ रिकॉर्डिंग शुरू करना

कस्टम डेटा के साथ रिकॉर्डिंग शुरू करने के लिए, यह तरीका अपनाएं. रिकॉर्डिंग सेशन शुरू, बंद करने, और उसे देखने के लिए, कृपया एआर (ऑगमेंटेड रिएलिटी) सेशन को रिकॉर्ड करना और उसे फिर से चलाना लेख देखें.

  1. ArRecordingConfig पाएं.
  2. कस्टम यूयूआईडी के साथ नया ArTrack बनाएं. पूरा कस्टम डेटा यहां सेव किया जाएगा.
  3. 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);

सभी नए ट्रैक को अलग-अलग रिकॉर्डिंग माना जाता है. रिकॉर्ड किए गए हर ट्रैक का अपना यूयूआईडी होता है.

वैकल्पिक: अतिरिक्त डेटा के साथ ट्रैक कॉन्फ़िगर करें

अगर आपको बाद में इसकी पहचान करनी है, तो ट्रैक को अतिरिक्त डेटा के साथ कॉन्फ़िगर किया जा सकता है. इससे सेशन की रिकॉर्डिंग के बारे में जानकारी मिलती है. उदाहरण के लिए, आप एक नोट जोड़कर एक ट्रैक को “टैग” कर सकते हैं जो उस स्थान और समय का वर्णन करता है जब आपने सत्र रिकॉर्ड किया था: “यह सत्र मॉल में दोपहर में रिकॉर्ड किया गया था.”

// 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 पर रिकॉर्ड किया जाता है. फ़्रेम पाने के लिए, एआर सेशन ArSession_update() का इस्तेमाल करते हैं. किसी फ़्रेम पर डेटा रिकॉर्ड करने का समय, वही समय होता है जब वीडियो चलने के दौरान डेटा वापस दिया जाता है. उदाहरण के लिए, अगर आपने ArFrame_recordTrackData() को 00:07:02 पर “A” वैल्यू के साथ कॉल किया है, तो ट्रैक को वापस चलाने पर आपको 00:07:02 के निशान पर “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);
}

कस्टम डेटा ट्रैक चलाएं

प्लेबैक के दौरान किसी सेशन की रिकॉर्डिंग से कस्टम डेटा निकालें.

वीडियो चलाना शुरू करना

कस्टम डेटा के साथ वीडियो चलाने की सुविधा को शुरू करना, किसी सामान्य सेशन की रिकॉर्डिंग को शुरू करने जैसा ही है.

कस्टम डेटा दिखाएं

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

आगे क्या होगा