Rzeczywistość rozszerzona z wyświetlaczem modeli >

Komponent internetowy <model-viewer> umożliwia wyświetlanie modeli 3D w internecie i interakcję z nimi. Umożliwia też płynne umieszczanie tych modeli w rzeczywistości rozszerzonej i interakcję z nimi.

Gdy komponent <model-viewer> z atrybutem ar jest wyświetlany na urządzeniu z Androidem obsługującym ARCore, pojawia się przycisk, jak w tym przykładzie:

Zrzut ekranu przeglądarki modeli

Po kliknięciu tego przycisku na urządzeniach z obsługą ARCore model zostanie wyświetlony za pomocą funkcji WebXR Chrome lub aplikacji Scene Viewer, w zależności od wartości atrybutu ar-modes.

Wygląd przycisku AR można dostosować za pomocą boksów komponentów internetowych. Przykład: <model-viewer> documentation. Więcej informacji o wyświetlaniu interaktywnych modeli 3D w trybie AR w przeglądarce lub aplikacji na Androida znajdziesz w artykule Przeglądarka scen.

Pierwsze kroki z <model-viewer>

Z podanych niżej instrukcji dowiesz się, jak zacząć korzystać z <model-viewer> na dowolnej stronie internetowej.

Dodaj zależność <model-viewer>

Z unpkg CDN

<script type="module" src="https://unpkg.com/@google/model-viewer/dist/model-viewer.min.js"></script>

Z npm

npm install @google/model-viewer

Następnie dodaj <model-viewer> w miejscu node_modules/model-viewer/dist/model-viewer.min.js, używając preferowanego narzędzia do tworzenia pakietów.

Uwzględnij tag <model-viewer>

Dodaj komponent internetowy <model-viewer> do dokumentu HTML:

<model-viewer src="https://modelviewer.dev/shared-assets/models/Astronaut.glb"
              ios-src="https://modelviewer.dev/shared-assets/models/Astronaut.usdz"
              alt="A 3D model of an astronaut"
              ar
              auto-rotate
              camera-controls></model-viewer>

Konfigurowanie tagu <model-viewer>

Wyświetlanie modelu można skonfigurować, zmieniając atrybuty tagu <model-viewer>. Te właściwości udostępniają opcje takie jak ruch kamery, animacje modeli i informacje o środowisku. W <model-viewer> dokumentacji znajdziesz listę wszystkich atrybutów, które można ustawić. Narzędzie Model Editor może wygenerować tag HTML <model-viewer> i skonfigurować właściwości takie jak pozycja kamery i oświetlenie.

Zrzut ekranu z Edytora modeli

Zgodność modelu

<model-viewer> obsługuje modele w formacie gltf i glb. Listę obsługiwanych rozszerzeń glTF znajdziesz na stronie three.js GLTFLoader documentation.

Aby mieć pewność, że model będzie wyświetlany prawidłowo, sprawdź go w Edytorze modeli.

Obsługa przeglądarek i urządzeń

Używanie interfejsu <model-viewer> do wyświetlania modeli 3D na stronie internetowej jest obsługiwane we wszystkich ponadczasowych przeglądarkach. Zalecamy użycie polyfilla :focus-visible, aby ukryć pierście skupienia, gdy element jest aktywny.

Funkcje AR wymagają obsługi ARCore oraz zainstalowania Usług Google Play dla AR. Informacje o trybie AR w webxr znajdziesz w sekcji Obsługa przeglądarek w WebXR. Jeśli WebXR nie jest obsługiwany, domyślnie będzie używany przeglądarka scen.

Dalsze kroki