ดูวิธีใช้ Augmented Images ในแอปของคุณเอง
ข้อกำหนดเบื้องต้น
ตรวจสอบว่าคุณเข้าใจแนวคิด AR พื้นฐาน และวิธีกำหนดค่าเซสชัน ARCore ก่อนดำเนินการต่อ
สร้างฐานข้อมูลรูปภาพ
สร้าง ArAugmentedImageDatabase
เพื่อเก็บรูปภาพอ้างอิง โดยมี 2 วิธีดังนี้
- สร้างฐานข้อมูลเปล่า
ArAugmentedImageDatabase* ar_augmented_image_database = NULL; ArAugmentedImageDatabase_create(ar_session, &ar_augmented_image_database);
- อ่านจากไฟล์ฐานข้อมูลรูปภาพ โปรดดู [แอปตัวอย่าง AugmentedImage] สำหรับ
util::LoadFileFromAssetManager
std::string database_buffer; util::LoadFileFromAssetManager(asset_manager_, "sample_database.imgdb", &database_buffer); uint8_t* raw_buffer = reinterpret_cast<uint8_t*>(&database_buffer.front()); ArAugmentedImageDatabase* ar_augmented_image_database = NULL; const ArStatus status = ArAugmentedImageDatabase_deserialize( ar_session, raw_buffer, database_buffer.size(), &ar_augmented_image_database);
คุณสร้างไฟล์ฐานข้อมูลด้วยเครื่องมือรูปภาพหรือการเรียกใช้ ArAugmentedImageDatabase_serialize()
ได้
เพิ่มรูปภาพไปยังฐานข้อมูล
ขั้นตอนนี้เป็นขั้นตอนที่ไม่บังคับหากรูปภาพอ้างอิงที่คุณต้องการโหลดจากไฟล์ฐานข้อมูลแล้ว หากต้องการเพิ่มรูปภาพระหว่างรันไทม์ ให้เรียกใช้ ArAugmentedImageDatabase_addImage()
ดังที่แสดงด้านล่าง โปรดดูแอปตัวอย่าง augmented_image_c เพื่อดูฟังก์ชันในเนมสเปซของ util
int32_t width, height, stride, index; uint8_t* image_pixel_buffer = nullptr; constexpr const char kSampleImageName[] = "default.jpg"; bool load_image_result = util::LoadImageFromAssetManager( kSampleImageName, &width, &height, &stride, &image_pixel_buffer); uint8_t* grayscale_buffer = nullptr; util::ConvertRgbaToGrayscale(image_pixel_buffer, width, height, stride, &grayscale_buffer); int32_t grayscale_stride = stride / 4; const ArStatus status = ArAugmentedImageDatabase_addImage( ar_session_, ar_augmented_image_database, kSampleImageName, grayscale_buffer, width, height, grayscale_stride, &index); // If the physical size of the image is known, you can instead use // ArStatus ArAugmentedImageDatabase_addImageWithPhysicalSize // This will improve the initial detection speed. ARCore will still actively // estimate the physical size of the image as it is viewed from multiple // viewpoints. delete[] image_pixel_buffer; delete[] grayscale_buffer;
ระบบจะใช้ค่า index
และ name
ในภายหลังเพื่อระบุรูปภาพอ้างอิงที่ตรวจพบ
เปิดใช้การติดตามรูปภาพ
กำหนดค่าเซสชัน ARCore เพื่อติดตามรูปภาพโดยการลงทะเบียนฐานข้อมูลรูปภาพ ดังนี้
ArConfig_setAugmentedImageDatabase(ar_session_, ar_config, ar_augmented_image_database); const ArStatus status = ArSession_configure(ar_session_, ar_config);
ในระหว่างเซสชัน ARCore จะใช้จุดฟีเจอร์จากรูปภาพจากกล้องเพื่อจับคู่กับผู้ที่อยู่ในฐานข้อมูลรูปภาพ
ค้นหารูปภาพแต่งเพิ่มเติมในเซสชัน AR
หากต้องการรับรูปภาพที่ตรงกัน ให้โพล ArAugmentedImage
ที่อัปเดตในลูปการอัปเดตเฟรม
// Update loop, in onDrawFrame ArTrackableList* updated_image_list = nullptr; ArTrackableList_create(ar_session_, &updated_image_list); ArFrame_getUpdatedTrackables( ar_session_, ar_frame_, AR_TRACKABLE_AUGMENTED_IMAGE, updated_image_list); int32_t image_list_size; ArTrackableList_getSize(ar_session_, updated_image_list, &image_list_size); for (int i = 0; i < image_list_size; ++i) { ArTrackable* ar_trackable = nullptr; ArTrackableList_acquireItem(ar_session_, updated_image_list, i, &ar_trackable); ArAugmentedImage* image = ArAsAugmentedImage(ar_trackable); ArTrackingState tracking_state; ArTrackable_getTrackingState(ar_session_, ar_trackable, &tracking_state); int image_index; ArAugmentedImage_getIndex(ar_session_, image, &image_index); if (tracking_state == AR_TRACKING_STATE_TRACKING) { util::ScopedArPose scopedArPose(ar_session_); ArAugmentedImage_getCenterPose(ar_session_, image, scopedArPose.GetArPose()); ArAnchor* image_anchor = nullptr; const ArStatus status = ArTrackable_acquireNewAnchor( ar_session_, ar_trackable, scopedArPose.GetArPose(), &image_anchor); // For example, you can now render content at the image anchor, choosing // content based on the image index (or name). } }
การรองรับกรณีการใช้งานต่างๆ
เมื่อตรวจพบรูปภาพเสริม ARCore จะสร้าง Trackable
สำหรับรูปภาพเสริมดังกล่าวและตั้งค่า ArTrackingState
เป็น TRACKING
และ ArAugmentedImageTrackingMethod
เป็น FULL_TRACKING
เมื่อรูปภาพที่ติดตามเลื่อนออกจากมุมมองกล้อง ARCore จะทำการตั้งค่า ArTrackingState
เป็น TRACKING
ต่อไป แต่เปลี่ยน ArAugmentedImageTrackingMethod
เป็น LAST_KNOWN_POSE
พร้อมทั้งกำหนดการวางแนวและตำแหน่งของรูปภาพต่อไป
แอปควรใช้สถานะการติดตามและวิธีการติดตามแตกต่างกันไปตามกรณีการใช้งานที่ตั้งใจ
รูปภาพคงที่ กรณีการใช้งานส่วนใหญ่ที่เกี่ยวข้องกับรูปภาพที่ยึดอยู่กับที่ (ซึ่งคาดว่าจะไม่มีการเคลื่อนไหว) สามารถใช้
ArTrackingState
เพื่อตรวจสอบว่าระบบตรวจพบรูปภาพหรือไม่และทราบตำแหน่งของรูปภาพหรือไม่ ละเว้นArAugmentedImageTrackingMethod
ได้รูปภาพเคลื่อนไหว หากแอปต้องติดตามภาพเคลื่อนไหว ให้ใช้ทั้ง
ArTrackingState
และArAugmentedImageTrackingMethod
เพื่อระบุว่ารูปภาพมีการตรวจจับหรือไม่และทราบตำแหน่งหรือไม่
Use Case | รูปภาพคงที่ | กำลังย้ายรูปภาพ |
---|---|---|
ตัวอย่าง | โปสเตอร์ที่แขวนบนผนัง | โฆษณาข้างรถเมล์ |
ท่าทางจะถือว่าถูกต้อง |
ArTrackingState == TRACKING |
ArTrackingState == TRACKING
และ ArAugmentedImageTrackingMethod == FULL_TRACKING
|