Để tuân thủ các yêu cầu về quyền riêng tư được cập nhật của chúng tôi đối với việc sử dụng ARCore SDK 1.12 trở lên, bạn phải tiết lộ việc sử dụng Cloud Anchors một cách nổi bật trong ứng dụng của mình. Xem các yêu cầu về quyền riêng tư của Cloud Anchors để biết thêm chi tiết.

Bắt đầu nhanh cho Cloud Anchor trong iOS

API ARCore Cloud Anchor hay dịch vụ ARCore Cloud Anchor, cung cấp các tính năng neo trên đám mây cho ứng dụng iOS của bạn, giúp người dùng trên cả thiết bị iOS và Android có thể chia sẻ trải nghiệm AR.

Tài liệu này sẽ hướng dẫn bạn cách:

  • Thiết lập môi trường phát triển của bạn để hợp tác với Cloud Anchor
  • Dùng thử tính năng lưu trữ và giải quyết quảng cáo cố định trong một ứng dụng mẫu

Yêu cầu

Để sử dụng Cloud Anchor, bạn sẽ cần:

  • Xcode phiên bản 10.1 trở lên

  • Cocoapods 1.4.0 trở lên

  • Thiết bị Apple tương thích với ARKit chạy iOS 11.0 trở lên (yêu cầu triển khai iOS 10.0 trở lên)

Sử dụng Neo neo

Các bước sau đây sử dụng ứng dụng mẫu Cloud Anchors để hiển thị cho bạn các tác vụ quan trọng để định cấu hình và xây dựng ứng dụng hỗ trợ ARCore Cloud Anchor.

Tải ứng dụng mẫu Cloud Anchors

  1. Sao chép hoặc tải SDK ARCore cho iOS từ GitHub để nhận mã ứng dụng mẫu.

  2. Mở cửa sổ Terminal hoặc Finder và chuyển đến thư mục mà bạn đã sao chép hoặc tải xuống SDK.

  3. Bạn có thể tìm thấy mã ứng dụng mẫu trong
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    Mã ứng dụng mẫu liên tục cố định trên đám mây có trong
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Thiết lập phiên

Ứng dụng mẫu thực hiện các tác vụ quan trọng sau đây trong khi thiết lập phiên hoạt động:

Thiết lập tính năng chia sẻ mã nhận dạng Cloud Anchor

Ứng dụng mẫu Cloud Anchors sử dụng Firebase để chia sẻ các mã Cloud Anchor giữa các thiết bị. Bạn có thể sử dụng một giải pháp khác trong ứng dụng của chính mình.

Cách thiết lập cơ sở dữ liệu Firebase trong ứng dụng mẫu:

  1. Làm theo hướng dẫn về Firebase để thêm Firebase vào ứng dụng của bạn.
  2. Tải tệp GoogleService-Info.plist được tạo ra trong quá trình thêm Firebase vào ứng dụng của bạn.
  3. Bật bộ nhớ Firebase cho mẫu:
    • Chuyển đến bảng điều khiển của Firebase và chọn dự án mà bạn thiết lập cho ứng dụng mẫu.
    • Chọn bảng điều khiển Database.
    • Trên tùy chọn Realtime Database, hãy nhấp vào Get Started.
    • Trình đơn Security rules for Realtime Database sẽ mở ra.
      • Để chạy mẫu, hãy chọn Start in test mode.
      • Xin lưu ý rằng nếu sử dụng Firebase cho một ứng dụng mà bạn dự định phát hành, bạn nên sử dụng các quy tắc bảo mật hạn chế hơn.
  4. Trong Xcode, hãy thêm tệp GoogleService-Info.plist vào ứng dụng của bạn, bên cạnh Info.plist.

Thêm khóa API

Để sử dụng Cloud Anchors, bạn cần thêm một khóa API vào ứng dụng.

  1. Lấy khóa API. Xem phần Thiết lập khóa API trong Trung tâm trợ giúp về Bảng điều khiển Google Cloud Platform nếu bạn mới làm việc với khóa API.

  2. Bật API Neo Core Anchor cho dự án Google Cloud Platform.

  3. Trong Xcode, hãy thêm khóa API của bạn vào ứng dụng. Để làm điều này, hãy thêm khóa này vào mã sau trong CloudAnchorManager.m:

    self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                 bundleIdentifier:nil
                                            error:nil];
    

Chạy bản cập nhật nhóm

Ứng dụng CloudAnchorExample vận chuyển bằng Podfile được định cấu hình trước với SDK ARCore và các phiên bản iOS mà bạn cần. Cách cài đặt các phần phụ thuộc này:

  1. Mở cửa sổ Thiết bị đầu cuối và chạy pod update từ thư mục chứa dự án Xcode.
    Thao tác này sẽ tạo tệp .xcworkspace mà bạn sẽ dùng sau này để tạo và chạy ứng dụng.

Xem bài viết Thêm SDK ARCore vào ứng dụng của bạn để biết thông tin chi tiết về cách định cấu hình Podfile trong các ứng dụng của riêng bạn.

  1. Mở tệp .xcworkspace cho dự án trong Xcode.

    Để tránh lỗi bản dựng, hãy đảm bảo rằng bạn đang tạo từ tệp .xcworkspace, chứ không phải tệp .xcodeproj.

Thay đổi mã gói ứng dụng

Trong Xcode, hãy thay đổi mã gói của ứng dụng để bạn có thể ký ứng dụng cùng với nhóm của mình.

Tạo và chạy ứng dụng

  1. Kết nối thiết bị của bạn và chạy ứng dụng trong Xcode.

  2. (Không bắt buộc) Nếu bạn đang xây dựng và chạy ứng dụng mẫu, hãy xem phần sau đây để biết thông tin chi tiết về cách sử dụng ứng dụng để lưu trữ và phân giải Neo neo.

Dùng thử ứng dụng mẫu

  1. Tạo và chạy ứng dụng mẫu từ tệp .xcworkspace để chạy ứng dụng trên thiết bị của bạn.

  2. Nếu được nhắc, hãy cấp quyền truy cập vào máy ảnh cho ứng dụng. ARKit sau đó bắt đầu phát hiện máy bay phía trước máy ảnh của bạn.

  3. Nhấn vào HOST để chuyển sang chế độ lưu trữ. Mã phòng để chia sẻ thẻ liên kết được lưu trữ sẽ được tạo và xuất hiện trên màn hình của bạn.

  4. Nhấn vào một máy bay để bắt đầu lưu trữ neo trên đó.

    • Ứng dụng sẽ đặt một đối tượng Android của Android lên máy bay và đính kèm một neo vào đó.
    • Yêu cầu lưu trữ được gửi đến API trung tâm đám mây ARCore. Yêu cầu của máy chủ bao gồm dữ liệu đại diện cho vị trí cố định so với các tính năng hình ảnh gần đó.
    • Sau khi lưu trữ, neo sẽ nhận được một mã dùng để phân giải các neo đám mây trong không gian này.
  5. Nhấn vào RESOLVE và nhập mã phòng để truy cập vào Cloud Anchor được lưu trữ trước đó cho phòng này bằng một thiết bị khác hoặc trên một thiết bị khác.

    • Yêu cầu giải quyết sẽ được gửi đến API Cloud Core Anchor.
    • Yêu cầu phân giải này có chứa mã nhận dạng cố định trên đám mây. Nếu mã nhận dạng đó khớp với văn bản liên kết được lưu trữ và việc bản địa hóa thành công, máy chủ sẽ trả về lượt chuyển đổi của văn bản liên kết trong tọa độ cục bộ của bạn.
    • Ứng dụng mẫu sử dụng phép biến đổi để thêm liên kết vào cảnh của bạn và hiển thị các đối tượng ảo được đính kèm vào cảnh đó.

Thêm SDK ARCore vào các ứng dụng của bạn

Trong các ứng dụng của riêng mình, bạn cần cập nhật Podfile để bao gồm SDK ARCore và phiên bản iOS được hỗ trợ. Cách thực hiện:

  1. Hãy thêm platformpod sau vào Podfile của dự án:

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.32.0'
    
  1. Mở cửa sổ Thiết bị đầu cuối và chạy pod update từ thư mục nơi dự án Xcode của bạn tồn tại.
    Thao tác này sẽ tạo tệp .xcworkspace mà bạn dùng để tạo và chạy ứng dụng.

Neo cố định trên đám mây

Như đã mô tả trong phần Lưu trữ neo cố định trên đám mây, bạn có thể đặt cho neo đám mây thời gian hoạt động tối đa 365 ngày. Mã mẫu để sử dụng quảng cáo cố định trên đám mây tồn tại trong thư mục /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample trong SDK ARCore cho iOS từ GitHub.

Các bước tiếp theo