Android पर एआर (ऑगमेंटेड रिएलिटी) सेशन को रिकॉर्ड करना और चलाना

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

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

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

अन्य ARCore एपीआई के साथ काम करने की सुविधा

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

शेयर किए गए कैमरे के साथ काम करना

शेयर किए गए कैमरे का इस्तेमाल करने वाले सेशन रिकॉर्ड किए जा सकते हैं. हालांकि, शेयर किए गए कैमरा मोड का इस्तेमाल करके, इन सेशन को चलाने की सुविधा अभी उपलब्ध नहीं है.

Cloud Anchors के साथ काम करता है या नहीं

किसी सेशन को रिकॉर्ड करने या उसे चलाने के दौरान, Cloud ऐंकर को होस्ट किया जा सकता है और उसका समाधान किया जा सकता है.

रिकॉर्ड किया गया

ARCore सेशन की रिकॉर्डिंग शुरू करें, बंद करें, और उसकी स्थिति देखें.

ARCore सेशन रिकॉर्ड करें

ARCore सेशन को रिकॉर्ड करने के लिए, सेशन को कॉन्फ़िगर करें और रिकॉर्डिंग के लिए MP4 यूआरआई उपलब्ध कराएं. session.resume() पर पहले कॉल करने से पहले, session.startRecording() पर कॉल करें. सेशन के फिर से शुरू होने पर, रिकॉर्डिंग अपने-आप शुरू हो जाती है. सेशन रोकने पर रिकॉर्डिंग अपने-आप बंद हो जाए, इसके लिए RecordingConfig.setAutoStopOnPause() बोलें. किसी खास सेशन को रिकॉर्ड करने के लिए, सेशन के चलने के दौरान session.startRecording() पर कॉल करें.

Java

// Configure the ARCore session.
Session session = new Session(context);
Uri destination = Uri.fromFile(new File(context.getFilesDir(), "recording.mp4"));
RecordingConfig recordingConfig =
        new RecordingConfig(session)
        .setMp4DatasetUri(destination)
        .setAutoStopOnPause(true);
try {
  // Prepare the session for recording, but do not start recording yet.
  session.startRecording(recordingConfig);
} catch (RecordingFailedException e) {
  Log.e(TAG, "Failed to start recording", e);
}

// Resume the ARCore session to start recording.
session.resume();

Kotlin

// Configure the ARCore session.
val session = Session(context)
val destination = Uri.fromFile(File(context.getFilesDir(), "recording.mp4"))
val recordingConfig = RecordingConfig(session)
  .setMp4DatasetUri(destination)
  .setAutoStopOnPause(true)
session.startRecording(recordingConfig)

// Resume the ARCore session to start recording.
session.resume()

सेशन की रिकॉर्डिंग बंद करना

मौजूदा एआर सेशन को रोके बिना रिकॉर्डिंग बंद करने के लिए, session.stopRecording() पर कॉल करें.

Java

try {
  session.stopRecording();  // Stop recording.
} catch (RecordingFailedException e) {
  Log.e(TAG, "Failed to stop recording", e);
}

Kotlin

session.stopRecording()

रिकॉर्डिंग की स्थिति देखना

session.getRecordingStatus() वर्तमान RecordingStatus का पता लगाने के लिए किसी भी समय इस्तेमाल किया जा सकता है.

Java

// Use any time to determine current RecordingStatus.
if (session.getRecordingStatus() == RecordingStatus.OK) {
  // Update the UI to show that the session is currently being recorded.
}

Kotlin

// Use any time to determine current RecordingStatus.
if (session.recordingStatus == RecordingStatus.OK) {
  // Update the UI to show that the session is currently being recorded.
}

वीडियो चलाएं

पहले से रिकॉर्ड किए गए एआर (ऑगमेंटेड रिएलिटी) सेशन को फिर से चलाएं. सेशन रीयल टाइम में चलते हैं. साथ ही, सेशन के चलने की स्पीड में बदलाव नहीं किया जा सकता.

पहले रिकॉर्ड किया गया सेशन चलाना

पहले से रिकॉर्ड किए गए सेशन को फिर से चलाने के लिए, session.resume() पर पहली कॉल करने से पहले session.setPlaybackDatasetUri() पर कॉल करें.

session.resume() को पहली बार कॉल करने की वजह से वीडियो चलना शुरू होने के बाद, session.pause() को कॉल करके सेशन को रोकने से डेटासेट में सभी कैमरा इमेज फ़्रेम और रिकॉर्ड किए गए सेंसर डेटा की प्रोसेसिंग निलंबित हो जाएगी. इस तरीके से खारिज किए गए कैमरा इमेज फ़्रेम और सेंसर फ़्रेम का डेटा, session.resume() को कॉल करके सेशन को फिर से शुरू करने पर दोबारा प्रोसेस नहीं किया जाएगा. आम तौर पर, प्रोसेस किए गए डेटा में अंतर की वजह से सेशन के लिए एआर ट्रैकिंग खराब होगी.

Java

// Configure the ARCore session.
Session session = new Session(context);

// Specify the previously recorded MP4 file.
Uri recordingUri = Uri.fromFile(new File(context.getFilesDir(), "recording.mp4"));
session.setPlaybackDatasetUri(recordingUri);
…

// Start playback from the beginning of the dataset.
session.resume();
…

// Pause the AR session, but silently continue MP4 playback. Camera frames
// and other recorded sensor data is discarded while the session is paused.
session.pause();
…

// Resume the AR session. Camera frames and other sensor data from the MP4
// that was silently played back while the session was paused is not
// processed by ARCore.
session.resume();

Kotlin

// Configure the ARCore session.
val session = Session(context)

// Specify the previously recorded MP4 file.
val recordingUri = Uri.fromFile(File(context.filesDir, "recording.mp4"))
session.playbackDatasetUri = recordingUri
…

// Start playback from the beginning of the dataset.
session.resume()
…

// Pause the AR session, but silently continue MP4 playback. Camera frames
// and other recorded sensor data is discarded while the session is paused.
session.pause()
…

// Resume the AR session. Camera frames and other sensor data from the MP4
// that was silently played back while the session was paused is not
// processed by ARCore.
session.resume()

वीडियो को फिर से चलाना

डेटासेट की शुरुआत से वीडियो चलाने के लिए, सेशन को रोकें और session.setPlaybackDatasetUri() को कॉल करें. साथ ही, सेशन को फिर से शुरू करने से पहले, वही MP4 रिकॉर्डिंग बताएं.

Java

session.pause();
// Pause and specify the SAME dataset:
session.setPlaybackDatasetUri(previousRecordingUri);
session.resume();  // Playback starts from the BEGINNING of the dataset.

Kotlin

session.pause()
// Pause and specify the SAME dataset:
session.playbackDatasetUri = previousRecordingUri
session.resume()  // Playback starts from the BEGINNING of the dataset.

कोई दूसरा सेशन फिर से चलाएं

किसी दूसरे डेटासेट को चलाने के लिए, सेशन को रोकें और उसे फिर से शुरू करने से पहले, नया डेटासेट डालें.

Java

// Switch to a different dataset.
session.pause();   // Pause the playback of the first dataset.
// Specify a different dataset to use.
session.setPlaybackDatasetUri(newRecordingUri);
session.resume();  // Start playback from the beginning of the new dataset.

Kotlin

// Switch to a different dataset.
session.pause()   // Pause the playback of the first dataset.
// Specify a different dataset to use.
session.playbackDatasetUri = newRecordingUri
session.resume()  // Start playback from the beginning of the new dataset.

वीडियो चलाने की स्थिति देखना

मौजूदा PlaybackStatus का पता लगाने के लिए, किसी भी समय session.getPlaybackStatus() का इस्तेमाल करें.

Java

// Use any time to determine current PlaybackStatus.
if (session.getPlaybackStatus() != PlaybackStatus.OK) {
  // Update the UI to show that the session playback has finished.
}

Kotlin

// Use any time to determine current PlaybackStatus.
if (session.playbackStatus != PlaybackStatus.OK) {
  // Update the UI to show that the session playback has finished.
}

आगे क्या होगा