Bắt đầu nhanh cho Cloud Anchor trong thực

Sử dụng Cloud Anchor để tạo các trải nghiệm AR mà người dùng Android và iOS có thể chia sẻ. 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 cho 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

Điều kiện tiên quyết

  • Hướng dẫn này giả định rằng bạn đã cài đặt và định cấu hình
    Unreal Công cụ 4.19 bằng trình bổ trợ GoogleARCore 1.3+.

    Nếu không, hãy xem Quickstart for Unreal để biết các bước cài đặt và thiết lập.

  • Nếu bạn mới làm việc với quảng cáo cố định, hãy xem bài viết Làm việc với quảng cáo cố định để biết phần giới thiệu.

Yêu cầu

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

Phần cứng

Nhắm mục tiêu Bạn cần có
Android
iOS
  • Một trong những chiếc iPhone tương thích với ARKit chạy iOS phiên bản 11 trở lên:
    • iPhone X
    • iPhone 8 và 8 Plus
    • iPhone 7 và 7 Plus
    • iPhone 6S và 6S Plus
    • iPhone SE

  • Cáp USB để kết nối điện thoại với máy phát triển

Phần mềm

Nhắm mục tiêu Bạn cần có
Android
iOS

Sử dụng neo neo trên đám mây

Các chức năng liên kết của Cloud có trong trình bổ trợ GoogleARCoreDịch vụ của Unreal.

Các phần sau đây cho bạn biết cách:

  • Thiết lập môi trường phát triển của bạn để làm việc với Cloud Anchor
  • Cài đặt và dùng thử ứng dụng mẫu

Ghi chú đặt tên cho ký tự liên kết trên đám mây

Triển khai Cloud Anchors thực dưới dạng CloudARPin, tương tự như ARPins. Plugin GoogleARCoreServices của Unreal và ứng dụng mẫu sẽ tuân theo quy ước đặt tên này. Hướng dẫn này cũng sẽ sử dụng thuật ngữ CloudARPin khi đề cập đến Cloud Anchor trong Unreal.

Định cấu hình môi trường phát triển của bạn

Nhắm mục tiêu Việc nên làm
Android Làm theo hướng dẫn Hướng dẫn nhanh thực tế dành cho Android
iOS Làm theo hướng dẫn Bắt đầu nhanh với iOS không thực

Xây dựng Unreal Engine bằng trình bổ trợ GoogleARCore

Để sử dụng CloudARPinSample, hãy nhớ tạo Unreal Engine 4.19 bằng trình bổ trợ GoogleARCore 1.3+ từ mã nguồn trước.

Để biết hướng dẫn, hãy xem phần Thiết lập môi trường phát triển của bạn trong Quickstart for Unreal ( ARCore).

Lấy mẫu

Lấy CloudARPinSample:

  • Tải arcore-unreal-sdk-1.7.0.zip xuống từ kho lưu trữ ARCore for Unreal SDK trên GitHub và trích xuất.

    –hoặc–

  • Sao chép kho lưu trữ bằng lệnh sau:

    git clone https://github.com/google-ar/arcore-unreal-sdk.git

Mở ứng dụng mẫu

Trong Unreal Editor, hãy mở dự án CloudARPinSample.

Các phần sau đây sẽ cho bạn biết cách định cấu hình mẫu để sử dụng Cloud Anchor.

Giới thiệu về tính năng chia sẻ mã nhận dạng Cloud Anchor

Ứng dụng mẫu CloudARPin sử dụng tính năng Nối mạng của Unreal để chia sẻ mã Cloud Anchor trên một mạng cục bộ.

Xem lại CloudARPinReplicatorARPlayerController trong mẫu CloudARPin để biết thông tin chi tiết về cách triển khai.

Bạn có thể sử dụng giải pháp nối mạng khác trong các ứng dụng của mình.

Thêm khóa API

Để sử dụng API CloudARpin trong trình bổ trợ GoogleARCoreServices trong ứng dụng, bạn cần có khóa API Google ARCore Cloud Anchor.

  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 Unreal, hãy thêm khoá API vào dự án:

    • Truy cập vào Cài đặt dự án GoogleARCore > GoogleARCoreDịch vụ.
    • Thêm khoá vào trường APIKey.

Đóng gói mẫu

Nhắm mục tiêu Việc nên làm
Android Làm theo hướng dẫn "Triển khai" trong bài viết Hướng dẫn khởi động nhanh thực tế cho Android
iOS Làm theo hướng dẫn "Triển khai" trong bài viết Bắt đầu nhanh với iOS không thực

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

Tạo và chạy ứng dụng mẫu CloudARPin để thử lưu trữ và giải quyết Cloud Anchor. Bạn có thể dùng thử ứng dụng này trên một hoặc nhiều điện thoại.

  1. Sau khi cài đặt xong, hãy tìm ứng dụng có tên CloudARPin trên điện thoại của bạn rồi chạy ứng dụng đó.

  2. Bắt đầu một phiên hoạt động trên một hoặc nhiều điện thoại:

    Loại phiên Việc nên làm
    Một điện thoại
    • Nhấn vào Bắt đầu phiên. Phiên hoạt động sẽ bắt đầu và địa chỉ IP của điện thoại sẽ hiển thị trên màn hình.
    Nhiều điện thoại
    • Hãy nhớ kết nối tất cả các điện thoại qua mạng Wi-Fi có quyền truy cập Internet và cho phép kết nối P2P.
    • Sử dụng một điện thoại làm người tổ chức. Chạy ứng dụng trên điện thoại này và nhấn vào Bắt đầu phiên. Phiên bắt đầu và địa chỉ IP của điện thoại sẽ hiển thị trên màn hình.
    • Trên các điện thoại khác:
      • Chạy ứng dụng và nhập địa chỉ IP của điện thoại lưu trữ.
      • Nhấn vào Tham gia sau khi phiên họp bắt đầu.

    Ứng dụng mẫu khởi chạy trên(các) điện thoại của bạn và 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 Máy chủ lưu trữ để vào chế độ lưu trữ.

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

    • Ứng dụng sẽ đặt một đối tượng Android của Android lên máy bay và đính kèm đối tượng đó vào ARPin.
    • Yêu cầu lưu trữ sẽ được gửi đến dịch vụ Google Cloud Anchor để tạo và bắt đầu lưu trữ CloudARPin. Yêu cầu của người tổ chức bao gồm dữ liệu đại diện cho vị trí của ARPin\u91 liên quan đến các tính năng trực quan gần đó.
    • Yêu cầu lưu trữ thành công sẽ thiết lập một CloudARPin được lưu trữ ở đây.
    • Ứng dụng sẽ hiển thị mã CloudARPin gồm 4 chữ số, được liên kết với CloudID của CloudARPin, sau khi yêu cầu lưu trữ thành công.
  5. (Không bắt buộc) Khi vẫn ở chế độ lưu trữ, bạn có thể lặp lại bước trước đó để lưu trữ thêm CloudARPin.

  6. Nhấn vào Hủy để thoát khỏi chế độ lưu trữ.

  7. Chọn một mã CloudARPin được trả về trước đó và nhấn vào Giải quyết để thêm CloudARPin đã lưu trữ trước đó vào cảnh của bạn.

    • CloudARPin mới được tạo với trạng thái theo dõi được đặt thành Paused.
    • Yêu cầu giải quyết sẽ được gửi đến dịch vụ Google Cloud Anchor.
    • Yêu cầu phân giải bao gồm mã CloudARPin đã lưu trữ. Nếu mã nhận dạng này khớp với một CloudARPin được lưu trữ, thì máy chủ sẽ trả về biến đổi của CloudARPin trong các tọa độ cục bộ của bạn.
    • Ứng dụng mẫu sử dụng phép biến đổi để hiển thị các đối tượng Android của Andy được đính kèm vào CloudARPin đã giải quyết.
  8. (Không bắt buộc) Nhấn vào Hủy và lặp lại bước trước đó để giải quyết các CloudARPin bổ sung.

Bước tiếp theo