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

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

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

आगे बढ़ने से पहले, पक्का करें कि आपने बुनियादी एआर (ऑगमेंटेड रिएलिटी) सिद्धांत और ARCore सेशन को कॉन्फ़िगर करने का तरीका समझ लिया है.

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

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

शेयर किए गए कैमरे के साथ काम करने की सुविधा

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

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

वीडियो को शुरुआत से रीस्टार्ट करना

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

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.
}

आगे क्या होगा