SDK ARCore cho iOS giao tiếp với ARKit để cung cấp các tính năng của Điểm neo trên đám mây, cho phép bạn chia sẻ điểm neo giữa các thiết bị iOS và Android trong cùng một môi trường.
Tìm hiểu cách sử dụng ARCore Cloud Anchor API hoặc dịch vụ ARCore Cloud Anchor trong ứng dụng của riêng bạn.
Điều kiện tiên quyết
- Xcode phiên bản 13.0 trở lên
- Cocoapods 1.4.0 trở lên nếu bạn sử dụng Cocoapods
- Thiết bị Apple tương thích với ARKit chạy iOS 12.0 trở lên (bắt buộc phải có mục tiêu triển khai iOS 12.0 trở lên)
Nếu bạn mới sử dụng Điểm neo trên đám mây:
Hãy đảm bảo rằng bạn hiểu rõ quy trình dùng để lưu trữ và phân giải một Điểm neo trên đám mây.
Đọc kỹ hướng dẫn bắt đầu nhanh để biết các yêu cầu về hệ thống, hướng dẫn thiết lập và cài đặt.
Xem một trong các mẫu về Điểm neo trên đám mây
Bật tính năng Điểm neo trên đám mây trong ứng dụng
Để sử dụng API Cloud Anchors, bạn phải tạo một GARSessionConfiguration và đặt thuộc tính cloudAnchorMode cho API đó, như mô tả trong phần Định cấu hình phiên ARCore trong iOS. Sử dụng setConfiguration:error: (GARSession) để đặt cấu hình.
Bạn cũng phải bật ARCore API cho ứng dụng của mình.
Lưu trữ và phân giải neo
Bạn có thể lưu trữ và phân giải neo trên đám mây bằng ARCore Cloud Anchor API. API này bao gồm các phương thức gọi lại cho các thao tác đã hoàn tất, cũng như các đối tượng Future có thể được thăm dò ý kiến.
Lưu trữ một phần nội dung cố định
Việc lưu trữ ARAnchor sẽ đặt neo vào một hệ toạ độ chung cho bất kỳ không gian thực nào.
Yêu cầu của máy chủ gửi dữ liệu hình ảnh đến máy chủ của Google. Máy chủ này sẽ liên kết vị trí của ARAnchor trong hệ toạ độ biểu thị không gian thực tế hiện tại. Một yêu cầu lưu trữ thành công sẽ trả về một mã neo trên đám mây mới. Bạn có thể chia sẻ và sử dụng mã này để phân giải neo sau này.
- (void)addAnchorWithTransform:(matrix_float4x4)transform {
self.arAnchor = [[ARAnchor alloc] initWithTransform:transform];
[self.sceneView.session addAnchor:self.arAnchor];
__weak ExampleViewController *weakSelf = self;
self.hostFuture = [self.cloudAnchorManager
hostCloudAnchor:self.arAnchor
completion:^(NSString *anchorId, GARCloudAnchorState cloudState) {
[weakSelf handleHostAnchor:anchorId cloudState:cloudState];
}
error:nil];
[self enterState:HelloARStateHosting];
}
Giải quyết một neo
Việc phân giải ARAnchor cho phép các thiết bị Android và iOS trong một không gian thực nhất định thêm các neo được lưu trữ trước đó vào các cảnh mới.
Yêu cầu phân giải sẽ gửi cho máy chủ của Google một mã neo trên đám mây cùng với dữ liệu hình ảnh từ khung hình hiện tại. Máy chủ sẽ cố gắng so khớp dữ liệu hình ảnh này với hình ảnh của vị trí được liên kết với Cloud Anchor hiện đang được lưu trữ. Khi giải quyết thành công, một neo mới sẽ được thêm vào phiên và được trả về.
- (void)resolveAnchorWithIdentifier:(NSString *)identifier {
GARResolveCloudAnchorFuture *garFuture =
[self.gSession resolveCloudAnchorWithIdentifier:identifier
completionHandler:completion
error:&error];
}
// Pass the ARFRame to the ARCore session every time there is a frame update.
// This returns a GARFrame that contains a list of updated anchors. If your
// anchor's pose or tracking state changed, your anchor will be in the list.
- (void)cloudAnchorManager:(CloudAnchorManager *)manager didUpdateFrame:(GARFrame *)garFrame {
for (GARAnchor *garAnchor in garFrame.updatedAnchors) {
if ([garAnchor isEqual:self.garAnchor] && self.resolvedAnchorNode) {
self.resolvedAnchorNode.simdTransform = garAnchor.transform;
self.resolvedAnchorNode.hidden = !garAnchor.hasValidTransform;
}
}
}
Mẫu thăm dò ý kiến GARSession không bắt buộc
Nếu bạn đang sử dụng Metal hoặc cần một tuỳ chọn thăm dò ý kiến, và ứng dụng của bạn chạy ở tốc độ tối thiểu là 30 khung hình/giây, hãy sử dụng mẫu sau để truyền ARFrame đến GARSession:
-(void)myOwnPersonalUpdateMethod {
ARFrame *arFrame = arSession.currentFrame;
NSError *error = nil;
GARFrame *garFrame = [garSession update:arFrame error:&error];
// your update code here
}
Hạn mức API
API ARCore có các hạn mức sau đây đối với băng thông yêu cầu:
| Loại hạn mức | Tối đa | Thời lượng | Áp dụng cho |
|---|---|---|---|
| Số neo | Vé loại không giới hạn | Không áp dụng | Dự án |
| Yêu cầu lưu trữ của liên kết cố định | 30 | phút | Địa chỉ IP và dự án |
| Yêu cầu resolve liên kết cố định | 300 | phút | Địa chỉ IP và dự án |
Các sự cố đã biết và cách giải quyết
Có một số vấn đề đã biết khi làm việc với SDK ARCore dành cho iOS.
Chế độ cài đặt giao thức mặc định gây ra sự cố ứng dụng không liên tục
Chế độ cài đặt của giao thức Xác thực API Metal và tính năng Ghi lại khung hình GPU được bật theo mặc định, đôi khi có thể khiến ứng dụng gặp sự cố trong SDK.
Chẩn đoán sự cố ứng dụng
Bất cứ khi nào bạn nghi ngờ đã xảy ra sự cố, hãy xem dấu vết ngăn xếp.
Nếu bạn thấy MTLDebugComputeCommandEncoder trong dấu vết ngăn xếp, thì đó có thể là do chế độ cài đặt giao thức mặc định.
Giải pháp
Chuyển đến Product > Scheme > Edit Scheme….
Mở thẻ Run.
Nhấp vào Options để xem chế độ cài đặt hiện tại.
Đảm bảo cả GPU Frame Capture và Metal API Validation đều tắt.
Tạo bản dựng và chạy ứng dụng của bạn.
Hãy xem CHANGELOG của Cocoapods để biết thêm các vấn đề đã biết.
Các điểm hạn chế
SDK ARCore dành cho iOS không hỗ trợ lệnh gọi phương thức setWorldOrigin(relativeTransform:) của ARKit.
Xem xét hiệu suất
Mức sử dụng bộ nhớ sẽ tăng lên khi bạn bật API ARCore. Dự kiến mức sử dụng pin của thiết bị sẽ tăng do mức sử dụng mạng và mức sử dụng CPU cao hơn.