API ghi và phát cho phép bạn quay video và dữ liệu thực tế tăng cường một lần trong một môi trường cụ thể và sử dụng nội dung đó để thay thế một phiên quay camera trực tiếp.
Điều kiện tiên quyết
Hãy đảm bảo bạn hiểu rõ các khái niệm cơ bản về AR và cách định cấu hình một phiên ARCore trước khi tiếp tục.
Khả năng tương thích với các API ARCore khác
Do cách xử lý dữ liệu phiên, API ARCore có thể tạo ra kết quả khác trong quá trình phát so với quan sát được trong quá trình ghi. Chúng cũng có thể tạo ra các kết quả khác nhau trong các phiên phát tiếp theo. Ví dụ: số lượng thiết bị có thể theo dõi được phát hiện, thời gian chính xác phát hiện chúng và tư thế của chúng theo thời gian có thể khác nhau trong khi phát.
Khả năng tương thích với Cloud Neo
Bạn có thể lưu trữ và phân giải Cloud Anchors (Neo trên đám mây) trong khi ghi hoặc phát lại một phiên.
Đang ghi
Bắt đầu, dừng và kiểm tra trạng thái ghi phiên ARCore.
Ghi lại phiên ARCore
Để ghi lại một phiên ARCore, hãy định cấu hình phiên đó và cung cấp URI MP4 để ghi lại. Hãy gọi ArSession_startRecording() trước cuộc gọi đầu tiên đến ArSession_resume(). Quá trình ghi sẽ tự động bắt đầu khi phiên tiếp tục. Để tự động dừng quay khi phiên bị tạm dừng, hãy gọi ArRecordingConfig_setAutoStopOnPause(). Để ghi lại một phần của phiên, hãy gọi ArSession_startRecording() khi phiên đó đang chạy.
ArRecordingConfig* recording_config = nullptr;
ArRecordingConfig_create(ar_session, &recording_config);
ArRecordingConfig_setMp4DatasetUri(ar_session, recording_config,
mp4_dataset_uri);
ArRecordingConfig_setAutoStopOnPause(ar_session, recording_config, true);
CHECK(ArSession_startRecording(ar_session, recording_config));
// …
// Resume ARCore session to start recording.
CHECK(ArSession_resume(ar_session));
// …
// Recording ends.
CHECK(ArSession_pause(ar_session));
Dừng ghi
Để dừng ghi mà không cần tạm dừng phiên thực tế tăng cường đang chạy, hãy gọi ArSession_stopRecording() và ArRecordingConfig_destroy().
ArStatus status = ArSession_stopRecording(ar_session); ArRecordingConfig_destroy(recording_config);
Kiểm tra trạng thái ghi
Bạn có thể sử dụng ArSession_getRecordingStatus() bất cứ lúc nào để xác định ArRecordingStatus hiện tại.
ArRecordingStatus recording_status;
// Can be called at any time.
ArSession_getRecordingStatus(ar_session, &recording_status);
if (recording_status == AR_RECORDING_NONE) {
// The dataset recorder is not recording.
} else if (recording_status == AR_RECORDING_OK) {
// The dataset recorder is recording normally.
} else if (recording_status == AR_RECORDING_IO_ERROR) {
// The dataset recorder encountered an error while recording.
}
Phát
Phát lại các phiên thực tế tăng cường đã ghi trước đó. Các phiên sẽ phát lại theo thời gian thực, và không thể điều chỉnh tốc độ hay cách phát lại phiên.
Phát lại phiên đã ghi lại trước đó
Để phát lại một phiên đã ghi trước đó, hãy gọi ArSession_setPlaybackDatasetUri() trước lệnh gọi đầu tiên đến ArSession_resume().
Khi quá trình phát đã bắt đầu do lệnh gọi đầu tiên đến ArSession_resume(), việc tạm dừng phiên bằng cách gọi ArSession_pause() sẽ tạm ngừng xử lý tất cả khung hình ảnh của máy ảnh và mọi dữ liệu cảm biến đã ghi khác trong tập dữ liệu. Khung hình ảnh của máy ảnh và dữ liệu khung cảm biến bị loại bỏ theo cách này sẽ không được xử lý lại khi phiên được tiếp tục bằng cách gọi ArSession_resume(). Hoạt động theo dõi thực tế tăng cường cho phiên thường sẽ bị ảnh hưởng do khoảng trống trong dữ liệu được xử lý.
// Specify previously recorded MP4 file. CHECK(ArSession_setPlaybackDatasetUri(ar_session, mp4_dataset_uri)); // … // Playback starts from the beginning of the dataset. CHECK(ArSession_resume(ar_session)); // … // Pause AR session, but allow playback to silently continue. CHECK(ArSession_pause(ar_session)); // … // Resume AR session. Playback continues with gap to paused session. CHECK(ArSession_resume(ar_session));
Bắt đầu phát lại từ đầu
Để bắt đầu phát lại từ đầu tập dữ liệu, hãy tạm dừng phiên và gọi ArSession_setPlaybackDatasetUri(), chỉ định cùng một bản ghi MP4 trước khi tiếp tục phiên.
CHECK(ArSession_pause(ar_session)); // Pause and specify the *same* dataset: CHECK(ArSession_setPlaybackDatasetUri(ar_session, mp4_dataset_uri)); // Playback starts from the *beginning* of the dataset. CHECK(ArSession_resume(ar_session));
Phát lại một phiên khác
Để phát lại một tập dữ liệu khác, hãy tạm dừng phiên và chỉ định tập dữ liệu mới trước khi tiếp tục phiên.
CHECK(ArSession_pause(ar_session)); // Pause and specify a *different* dataset: CHECK(ArSession_setPlaybackDatasetUri(ar_session, other_mp4_dataset_uri)); // Playback starts from the *beginning* of the new dataset. CHECK(ArSession_resume(ar_session));
Kiểm tra trạng thái phát
Sử dụng ArSession_getPlaybackStatus() bất cứ lúc nào để xác định ArPlaybackStatus hiện tại.
ArPlaybackStatus playback_status;
// Can be called at any time.
ArSession_getPlaybackStatus(ar_session, &playback_status);
if (playback_status == AR_PLAYBACK_NONE) {
// The session is not playing back an MP4 dataset file.
} else if (playback_status == AR_PLAYBACK_OK) {
// Playback is in process without issues.
} else if (playback_status == AR_PLAYBACK_IO_ERROR) {
// Playback has stopped due to an error.
} else if (playback_status == AR_PLAYBACK_FINISHED) {
// Playback has finished successfully.
}
Bước tiếp theo
- Tìm hiểu cách thêm dữ liệu tuỳ chỉnh vào các phiên đã ghi lại.