SDK ARCore dành cho giao diện iOS với ARKit để cung cấp Cloud Anchor cho phép bạn chia sẻ quảng cáo cố định cuối màn hình giữa 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 các ứ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 sử dụng Cocoapods
- Một thiết bị Apple tương thích với ARKit chạy iOS 12.0 trở lên (mục tiêu triển khai bắt buộc đối với iOS 12.0 trở lên)
Nếu bạn mới sử dụng Cloud Anchors:
Đả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 Đám mây Quảng cáo cố định cuối màn hình.
Đọc qua phầ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à hướng dẫn cài đặt.
Xem một trong các mẫu của Cloud Anchor
Bật Cloud Anchors trong ứng dụng của bạn
Để sử dụng API Cloud Anchors, bạn phải tạo một
GARSessionConfiguration
rồi đặt thuộc tính cloudAnchorMode cho thuộc tính đó, như được mô tả trong
Định cấu hình một 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 bạn.
Lưu trữ và phân giải các quảng cáo cố định
Bạn có thể lưu trữ và phân giải neo trên đám mây bằng API ARCore Cloud Anchor API. API bao gồm phương thức gọi lại cho các thao tác đã hoàn tất, cũng như đối tượng Tương lai có thể thăm dò ý kiến.
Lưu trữ quảng cáo 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.
Yêu cầu của máy chủ lưu trữ gửi dữ liệu trực quan đến máy chủ của Google, máy chủ này ánh xạARAnchor
vị trí trong hệ toạ độ biểu thị không gian thực hiện tại. Đáp
khi yêu cầu lưu trữ thành công, sẽ trả về một mã Cloud Anchor mới có thể được chia sẻ và
dùng để phân giải quảng cáo cố định 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];
}
Phân giải quảng cáo cố định
Việc giải quyết ARAnchor cho phép các thiết bị Android và iOS ở trong một không gian thực tế nhất định
để thêm quảng cáo cố định được lưu trữ trước đây vào cảnh mới.
Yêu cầu phân giải sẽ gửi cho máy chủ Google một mã neo trên đám mây cùng với dữ liệu trực quan khỏi khung hiện tại. Máy chủ sẽ cố gắng so khớp dữ liệu hình ảnh này bằng hình ảnh về vị trí liên kết Cloud Anchors hiện đang được lưu trữ. Thời gian giải quyết thành công, một neo mới được thêm vào phiên và 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 có tuỳ chọn thăm dò ý kiến, và ứng dụng của bạn chạy ở
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 cho 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ố lượng quảng cáo cố định | Vé loại không giới hạn | Không áp dụng | Dự án |
| Yêu cầu máy chủ cố định | 30 | phút | Địa chỉ IP và dự án |
| Yêu cầu giải quyế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 lược đồ mặc định gây ra sự cố ứng dụng không liên tục
Chế độ cài đặt lược đồ Chụp GPU và Xác thực API kim loại được bật bằng mặc định, điều này đô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ờ có sự cố đã xảy ra, hãy xem dấu vết ngăn xếp của bạn.
Nếu bạn thấy MTLDebugComputeCommandEncoder trong dấu vết ngăn xếp, thì có thể là do
thành 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 các chế độ cài đặt hiện tại.
Hãy đảm bảo rằng 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ớ 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ị tăng lên do mức sử dụng mạng và mức sử dụng CPU cao hơn.