Trình xem cảnh là một trình xem sống động cho phép trải nghiệm 3D và AR trên trang web hoặc ứng dụng Android của bạn. Công cụ này cho phép người dùng thiết bị di động Android dễ dàng xem trước, đặt, xem và tương tác với các mô hình 3D được lưu trữ trên web trong môi trường của họ.
Hầu hết các trình duyệt Android đều hỗ trợ Scene Viewer. Scene Viewer đã được nhiều đối tác của Google triển khai thành công để hỗ trợ trải nghiệm 3D và AR một cách đáng tin cậy. Nền tảng này cũng hỗ trợ các trải nghiệm này cho Google Tìm kiếm.
Cách triển khai rất đơn giản:
Trải nghiệm dựa trên nền tảng web chỉ yêu cầu các đường liên kết được định dạng chính xác trên một trang web.
Trải nghiệm dựa trên ứng dụng chỉ yêu cầu tích hợp một vài dòng mã Java.
Yêu cầu về thời gian chạy của Scene Viewer
Để trải nghiệm tính năng thực tế tăng cường (AR) bằng Trình xem cảnh, người dùng phải có:
- Một thiết bị hỗ trợ ARCore chạy Android 7.0 Nougat (API cấp 24) trở lên.
- Phiên bản mới nhất (mới) của Dịch vụ Google Play cho Thực tế tăng cường. Dịch vụ này được tự động cài đặt và cập nhật trên hầu hết thiết bị hỗ trợ ARCore.
- Phiên bản mới nhất của ứng dụng Google. Ứng dụng này được cài đặt sẵn và cũng tự động cập nhật trên phần lớn các thiết bị hỗ trợ ARCore.
Để cung cấp trong trường hợp không có Dịch vụ Google Play cho Thực tế tăng cường hoặc ứng dụng Google hoặc các phiên bản đã cài đặt quá cũ, bạn có thể chỉ định một URL dự phòng để khởi chạy một trải nghiệm thay thế, chẳng hạn như trang web, thông báo lỗi hoặc trải nghiệm dự phòng mà bạn đã tạo.
Trường hợp sử dụng được hỗ trợ
Trường hợp sử dụng dự kiến | Ứng dụng được đề xuất | Lợi ích |
---|---|---|
Từ một nút hoặc đường liên kết trên trang web hoặc ứng dụng Android, hãy chạy chế độ xem thực tế tăng cường (AR) gốc của một mô hình 3D.
Nếu thiết bị không có Dịch vụ Google Play cho Thực tế tăng cường, hãy linh hoạt hiển thị mô hình ở chế độ 3D có sự hỗ trợ của Trình xem cảnh. |
Chạy Trình xem cảnh bằng cách sử dụng một ý định tường minh đối với gói Google Tìm kiếm và chọn một chế độ cài đặt mode thích hợp để hiển thị mô hình 3D.
|
|
Từ một nút hoặc đường liên kết trên trang web hoặc ứng dụng Android, hãy chạy chế độ xem thực tế tăng cường (AR) gốc của một mô hình 3D.
Nếu thiết bị không có Dịch vụ Google Play cho Thực tế tăng cường (AR), hãy kiểm soát hành vi dự phòng. |
Chạy Trình xem cảnh bằng cách sử dụng một ý định tường minh đối với Dịch vụ Google Play cho Thực tế tăng cường (ARCore) và chọn một chế độ cài đặt mode thích hợp để hiển thị mô hình 3D.
|
Sử dụng trình xem mô hình 3D của riêng bạn hoặc cung cấp một phản hồi dự phòng khác về thiết kế của riêng bạn cho các trường hợp sử dụng không phải AR. |
Lưu trữ chế độ xem cùng dòng của mô hình 3D trên trang web của bạn và cho phép người dùng tự chuyển sang chế độ AR gốc toàn màn hình. | Sử dụng <model-viewer> hoặc bất kỳ trình xem 3D dựa trên nền tảng web nào khác để chạy Scene Viewer hiển thị nguyên gốc mô hình 3D trong môi trường thực tế tăng cường. |
|
Chạy Scene Viewer bằng cách sử dụng một ý định tường minh (3D hoặc AR)
Để hỗ trợ nhiều thiết bị Android nhất có thể, hãy sử dụng ý định tường minh trong Android để chạy Scene Inspector (Trình xem cảnh). Ý định tường minh có thể được kích hoạt từ trang HTML hoặc ứng dụng Android gốc. Ý định này sẽ do ứng dụng Google cài đặt sẵn trên các thiết bị Android hỗ trợ ARCore xử lý.
Tuỳ thuộc vào các tham số ý định được định cấu hình và khả năng của thiết bị, các mô hình 3D tương tác có thể được đặt trong môi trường của người dùng hoặc quay lại hiển thị trong trình xem 3D.
Nếu thiết bị đã cập nhật Dịch vụ Google Play cho Thực tế tăng cường, Trình xem cảnh sẽ hiển thị mô hình trong chế độ xem gốc thực tế tăng cường hoặc chế độ xem 3D.
Nếu Dịch vụ Google Play cho Thực tế tăng cường (AR) không có sẵn hoặc chưa cập nhật, thì Trình xem cảnh sẽ dễ dàng quay lại hiển thị mô hình ở chế độ xem 3D.
Nếu không thể hiển thị mô hình 3D, chẳng hạn như do ứng dụng Google chưa được cài đặt hoặc là một phiên bản cũ, thì tham số
S.browser_fallback_url
sẽ được dùng để hiển thị trang web dự phòng.
Khởi chạy Scene Editor (Trình xem cảnh) từ HTML hoặc Java
HTML
Để kích hoạt ý định tường minh từ HTML, hãy sử dụng cú pháp sau:
<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>
Java
Để kích hoạt ý định tường minh qua Java, hãy dùng mã sau:
Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
sceneViewerIntent.setData(Uri.parse("https://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf"));
sceneViewerIntent.setPackage("com.google.android.googlequicksearchbox");
startActivity(sceneViewerIntent);
Tạo phiên bản ý định
Phiên bản ý định được biểu thị bằng số phiên bản sau arvr.google.com/scene-viewer
. Ví dụ: bản phát hành ban đầu sử dụng phiên bản 1.0. Khi cần có các tính năng mới của Scene Viewer, bạn có thể chạy Scene Viewer có phiên bản ý định cao hơn tương ứng với các tính năng mà bạn yêu cầu.
Intent phiên bản 1.1 bổ sung tính năng hỗ trợ cho các đường liên kết intent://
, vốn có thể chạy
trực tiếp vào ứng dụng Android thay vì vào một URL. Nếu bạn muốn Trình xem cảnh đảm bảo rằng chức năng này sẽ hoạt động ngay khi khởi chạy và không chạy được, hãy chạy trình xem cảnh với ý định intent://arvr.google.com/scene-viewer/1.1
.
Tham số ý định được hỗ trợ
Các tham số sau đây được hỗ trợ cho một ý định tường minh đối với gói Google Tìm kiếm.
Tham số ý định | Giá trị được phép | Nhận xét |
---|---|---|
file (bắt buộc) |
URL hợp lệ | URL này chỉ định tệp glTF hoặc glb cần được tải vào Trình xem cảnh. Tên này phải là ký tự thoát URL. |
S.browser_fallback_url (bắt buộc đối với các ý định dựa trên HTML) |
URL hợp lệ | Đây là tính năng của Google Chrome chỉ được hỗ trợ cho các triển khai dựa trên web. Khi ứng dụng Google không có trên thiết bị, đây là URL mà Google Chrome truy cập. |
mode (không bắt buộc) |
3d_preferred (mặc định) |
Trình xem cảnh hiển thị mô hình ở chế độ 3D bằng nút Xem trong không gian của bạn.
Nếu thiết bị không có Dịch vụ Google Play cho thực tế tăng cường, thì nút Xem trong không gian của bạn sẽ bị ẩn. |
3d_only |
Scene Viewer khởi chạy với mô hình hiển thị ở chế độ 3D, ngay cả khi thiết bị đã có Dịch vụ Google Play cho Thực tế tăng cường.
Nút Xem trong không gian của bạn sẽ không bao giờ xuất hiện.
|
|
ar_preferred |
Scene Viewer chạy ở chế độ thực tế tăng cường (AR) dưới dạng chế độ nhập. Người dùng có thể chuyển đổi giữa chế độ AR và 3D thông qua các nút Xem trong không gian của bạn và Xem ở chế độ 3D.
Nếu không có Dịch vụ Google Play cho Thực tế tăng cường, Trình xem cảnh sẽ dễ dàng quay lại sử dụng chế độ 3D làm chế độ nhập cảnh. |
|
ar_only |
Khi sử dụng giá trị này, bạn nên khởi chạy thông qua một ý định tường minh trong Android đến com.google.ar.core .
Lưu ý: Không dùng chế độ ar_only khi chạy qua
ý định tường minh trên Android
đến ứng dụng Google.
|
|
link (không bắt buộc) |
URL hợp lệ |
URL của một trang web bên ngoài. Nếu có, một nút sẽ xuất hiện trong giao diện người dùng có ý định chuyển đến URL này khi người dùng nhấp vào.
|
title (không bắt buộc) |
Chuỗi hợp lệ |
Tên cho mô hình. Nếu có, thông số này sẽ hiển thị trong giao diện người dùng.
Tên sẽ bị cắt bớt bằng dấu ba chấm sau 60 ký tự.
|
âm thanh (không bắt buộc) | URL hợp lệ | URL đến một bản âm thanh lặp lại được đồng bộ hoá với ảnh động đầu tiên được nhúng trong tệp glTF. Thuộc tính này phải được cung cấp cùng với một glTF với ảnh động có độ dài phù hợp. Nếu có, âm thanh sẽ được lặp lại sau khi mô hình được tải. Tên này phải là ký tự thoát URL. |
resizable (không bắt buộc) |
true (mặc định)
|
Khi bạn đặt thành false , người dùng sẽ không thể mở rộng mô hình trong trải nghiệm thực tế tăng cường. Việc chuyển tỷ lệ hoạt động bình thường trong trải nghiệm 3D.
|
enable_vertical_placement (không bắt buộc) |
false (mặc định)
|
Khi bạn thiết lập thành true , người dùng sẽ có thể đặt mô hình trên một nền tảng dọc.
|
Hướng dẫn về trải nghiệm người dùng
Để cung cấp trải nghiệm người dùng tốt nhất có thể, các lời gọi hành động rõ ràng nên truyền tải rằng người dùng sắp bước vào một môi trường sống động.
Đối với trải nghiệm xem 3D, bạn nên sử dụng một lời kêu gọi hành động có nhãn Xem ở chế độ 3D giống như một trong các hình ảnh sau:
Chạy Scene Viewer sử dụng một ý định tường minh đối với Dịch vụ Google Play cho Thực tế tăng cường (chỉ ở chế độ thực tế tăng cường)
Chế độ thực tế tăng cường (AR) trong Scene Viewer sử dụng Dịch vụ Google Play cho Thực tế tăng cường (AR).
Để đảm bảo thực tế tăng cường có trong Scene Viewer, bạn có thể sử dụng ý định tường minh trong Android từ trang web hoặc ứng dụng Android gốc để chạy Scene Viewer thông qua com.google.ar.core package
và cung cấp browser_fallback_url
. Bằng cách này, bạn có thể đảm bảo rằng tất cả người dùng đều có trải nghiệm thực tế tăng cường gốc thông qua Scene Viewer hoặc trải nghiệm dự phòng do bạn tự xây dựng. Ví dụ: bạn có thể xây dựng các trải nghiệm dự phòng như trình xem 3D của riêng mình hoặc một thông báo lỗi linh hoạt.
Để kích hoạt ý định tường minh từ HTML, hãy sử dụng cú pháp sau:
<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf&mode=ar_only#Intent;scheme=https;package=com.google.ar.core;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>;
Để kích hoạt ý định tường minh qua Java, hãy dùng mã sau:
Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
Uri intentUri =
Uri.parse("https://arvr.google.com/scene-viewer/1.0").buildUpon()
.appendQueryParameter("file", "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf")
.appendQueryParameter("mode", "ar_only")
.build();
sceneViewerIntent.setData(intentUri);
sceneViewerIntent.setPackage("com.google.ar.core");
startActivity(sceneViewerIntent);
Tham số ý định được hỗ trợ
Các tham số sau đây được hỗ trợ cho một ý định tường minh đối với gói Dịch vụ Google Play cho Thực tế tăng cường.
Tham số ý định | Giá trị được phép | Nhận xét |
---|---|---|
browser_fallback_url (bắt buộc đối với các ý định dựa trên HTML) |
URL hợp lệ | Tính năng này chỉ được hỗ trợ cho các hoạt động triển khai dựa trên web. Khi Dịch vụ Google Play cho Thực tế tăng cường (AR) không có trên thiết bị hoặc không được cập nhật, đây là URL mà thiết bị sẽ truy cập. |
mode (không bắt buộc) |
ar_only |
Scene Viewer luôn chạy mô hình 3D trong chế độ xem thực tế tăng cường gốc và ẩn mọi giao diện người dùng để chuyển sang Trình xem 3D của Scene Viewer.
Nếu không có Dịch vụ Google Play cho Thực tế tăng cường, Trình xem cảnh sẽ chạy URL bạn đặt trong browser_fallback_url cho các trải nghiệm dựa trên nền tảng web.
Đối với các trải nghiệm dựa trên ứng dụng, Scene Viewer sẽ quay lại trải nghiệm thay thế, chẳng hạn như thông báo lỗi hoặc trải nghiệm khác do bạn tự xây dựng.
|
ar_preferred |
Trình xem cảnh chạy ở chế độ gốc thực tế tăng cường (AR) dưới dạng chế độ nhập và cung cấp cho người dùng tuỳ chọn để chuyển đổi giữa chế độ AR và 3D thông qua các nút Xem trong không gian của bạn và Xem ở chế độ 3D.
Nếu không có Dịch vụ Google Play cho Thực tế tăng cường, Trình xem cảnh sẽ chạy URL bạn đặt trong browser_fallback_url cho các trải nghiệm dựa trên nền tảng web.
Đối với các trải nghiệm dựa trên ứng dụng, Scene Viewer sẽ quay lại trải nghiệm thay thế, chẳng hạn như thông báo lỗi hoặc trải nghiệm khác do bạn tự xây dựng.
|
|
link (không bắt buộc) |
URL hợp lệ |
URL của một trang web bên ngoài. Nếu có, một nút sẽ xuất hiện trong giao diện người dùng nhằm định nghĩa URL này khi người dùng nhấp vào.
Phiên bản 1.1 thêm tính năng hỗ trợ cho các đường liên kết intent:// trong Trình xem cảnh để cho phép nút truy cập của Trình xem cảnh kích hoạt trực tiếp trong các ứng dụng khác. Lưu ý bạn nên sử dụng thuộc tính này một cách cẩn thận và chỉ nên chỉ định khi chắc chắn trình xử lý ý định sẽ có mặt cho ý định nhất định. |
title (không bắt buộc) |
Chuỗi hợp lệ |
Tên cho mô hình. Nếu có, thông số này sẽ hiển thị trong giao diện người dùng.
Tên sẽ bị cắt bớt bằng dấu ba chấm sau 60 ký tự.
Phiên bản 1.1 bổ sung tính năng hỗ trợ việc định kiểu html cho nội dung tiêu đề, với số lượng văn bản tuỳ ý được cho phép. Xin lưu ý rằng tiêu đề phải là ký tự thoát url. |
sound (không bắt buộc) |
URL hợp lệ | Một URL đến một bản âm thanh lặp lại được đồng bộ hoá với ảnh động đầu tiên được nhúng trong tệp glTF. Thuộc tính này phải được cung cấp cùng với glTF với ảnh động có độ dài phù hợp. Nếu có, âm thanh sẽ được lặp lại sau khi mô hình được tải. |
resizable (không bắt buộc) |
true (mặc định)
|
Khi bạn đặt thành false , người dùng sẽ không thể mở rộng mô hình trong trải nghiệm thực tế tăng cường. Việc chuyển tỷ lệ hoạt động bình thường trong trải nghiệm 3D.
|
disable_occlusion (không bắt buộc) |
false (mặc định)
|
Khi bạn đặt thành true , các đối tượng được đặt trong cảnh sẽ luôn xuất hiện phía trước các đối tượng thế giới thực trong cảnh đó. Hãy xem phần
[Bật tính năng che khuất](/ar/develop/Base#enable_occlusion) để biết thêm thông tin.
|
Hướng dẫn về trải nghiệm người dùng
Để cung cấp trải nghiệm người dùng tốt nhất có thể, bạn nên làm theo các nguyên tắc sau.
Đối với trải nghiệm thực tế tăng cường, lời kêu gọi hành động hiển thị phải cho người dùng biết rằng người dùng sắp bước vào một môi trường sống động. Bạn nên sử dụng lời kêu gọi hành động Xem trong không gian của bạn:
Có thể người dùng chưa cài đặt Dịch vụ Google Play cho Thực tế tăng cường trên thiết bị của họ. Sau đây là cách
<model-viewer>
xử lý bản dự phòng và bạn có thể dùng đoạn mã đó làm điểm xuất phát.// Check whether this is an Android device. const isAndroid = /android/i.test(navigator.userAgent); // This fallback URL is used if the Google app is not installed and up to date. const fallbackUrl = 'https://arvr.google.com/scene-viewer?file=https%3A%2F%2Fstorage.googleapis.com%2Far-answers-in-search-models%2Fstatic%2FTiger%2Fmodel.glb&link=https%3A%2F%2Fgoogle.com&title=Tiger'; // This intent URL triggers Scene Viewer on Android and falls back to // fallbackUrl if the Google app is not installed and up to date. const sceneViewerUrl = 'intent://arvr.google.com/scene-viewer/1.0?file=https://storage.googleapis.com/ar-answers-in-search-models/static/Tiger/model.glb&title=Tiger#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=' + fallbackUrl + ';end;'; // Create a link. var a = document.createElement('a'); a.appendChild(document.createTextNode('Tiger')); // Set the href to the intent URL on Android and the fallback URL // everywhere else. a.href = isAndroid ? sceneViewerUrl : fallbackUrl; // Add the link to the page. document.body.appendChild(a);
Sử dụng <model-viewer>
để chạy Scene Viewer
Bạn có thể bật Scene Viewer trên trang web của mình bằng cách thêm thành phần web <model-viewer>
với thuộc tính ar
.
<model-viewer ar
ar-modes="scene-viewer webxr quick-look"
alt="A 3D model of an astronaut."
src="Astronaut.gltf"></model-viewer>
Khi xem trên thiết bị Android hỗ trợ ARCore, trang web chứa thành phần <model-viewer>
có thuộc tính ar
sẽ hiển thị một nút như minh hoạ trong ví dụ sau.
Khi sử dụng chế độ scene-viewer
trong ar-modes
, chế độ này sẽ chuyển sang chế độ xem thực tế tăng cường gốc và mời người dùng đặt mô hình vào môi trường của họ bằng Scene View (Trình xem cảnh).
Nếu không có Dịch vụ Google Play có thực tế tăng cường (AR), thì khi nhấn vào nút này, mô hình sẽ hiển thị trong trình xem 3D của <model-viewer>
.
Xem tài liệu liên quan đến <model-viewer>
để biết thêm thông tin về cách bắt đầu sử dụng <model-viewer>
.
Yêu cầu về tệp đối với mô hình
Scene Viewer có các tính năng hỗ trợ và giới hạn sau đây dành cho mô hình.
Hỗ trợ định dạng tệp | glTF 2.0/glb , sử dụng các tiện ích sau:
|
Ảnh động |
glTF chứa nhiều ảnh động, Trình xem cảnh chỉ phát ảnh động đầu tiên.
|
Giới hạn được đề xuất |
Hiệu suất tổng thể của thành phần phụ thuộc vào việc thiết lập các điều kiện ràng buộc và việc đánh đổi giữa các đỉnh, vật liệu, độ phân giải của hoạ tiết, lưới trên mỗi vật liệu và các yếu tố khác. Hãy làm theo các nguyên tắc sau để tối ưu hoá thành phần của bạn.
|
Hỗ trợ bóng | Bóng cứng do Scene Viewer tự động kết xuất khi đặt một đối tượng, vì vậy, bạn không nên hấp thụ bóng vào mô hình. |
Hỗ trợ hoạ tiết |
|
Material | PBR (đánh giá hoạt động tuần) |
Đang tải tệp | HTTPS |
Scene |
|
Sử dụng công cụ xem trước để xác thực mô hình 3D
Để đảm bảo tệp mô hình 3D của bạn sẽ hiển thị chính xác trong Scene Viewer, hãy sử dụng công cụ xem trước trực tuyến của chúng tôi để xác thực tệp trên máy tính.
Xác thực mô hình 3D của bạn
Để xác thực một mô hình, công cụ trình xem trước cần có một tệp glb hoặc glTF, mọi tệp hình ảnh và tệp bin liên kết, cũng như một tệp âm thanh không bắt buộc. Tệp âm thanh sẽ lặp lại cùng với ảnh động 0.
Bạn có thể chọn nhiều tệp riêng lẻ, hoặc tuỳ ý đặt glb hoặc glTF và các tệp liên kết với các tệp đó vào một tệp zip. (Phương thức tệp zip không hỗ trợ tệp âm thanh.)
Cách xác thực mô hình 3D:
Mở công cụ xem trước trực tuyến trong trình duyệt.
Hãy sử dụng một trong các phương pháp sau để thêm tệp vào công cụ xem trước:
Kéo và thả. Chọn một tệp glb hoặc glTF và tất cả các tệp liên kết với tệp đó (hoặc một tệp zip chứa những tệp này), rồi kéo các tệp hoặc tệp zip đã chọn vào công cụ xem trước.
Từ công cụ xem trước. Trong công cụ trình xem trước, hãy chọn Scene Viewer > Load File (Trình xem cảnh > Tải tệp). Chọn một tệp glb hoặc glTF và tất cả các tệp liên kết với tệp đó (hoặc một tệp zip chứa những tệp này) rồi nhấp vào Open (Mở).
Sau khi bạn tải các tệp chứa mô hình 3D vào công cụ xem trước, một bảng điều khiển ở cuối trình duyệt sẽ hiển thị kết quả, bao gồm cả mọi thông báo lỗi.
Thêm mô hình 3D để xác thực
Để xác thực mô hình 3D, hãy thêm các tệp tạo nên mô hình 3D đó vào công cụ Trình chỉnh sửa mô hình của chúng tôi.
Để xác thực một mô hình, trình xem trước cần có tệp glb hoặc glTF của mô hình, mọi tệp bin và hình ảnh liên kết cũng như tệp âm thanh không bắt buộc. Bạn có thể chọn nhiều tệp riêng lẻ hoặc thêm một tệp zip duy nhất.
Khi thêm tệp zip, trình xem trước sẽ tải glb hoặc glTF đầu tiên tìm thấy, cũng như hình ảnh và các tệp bin liên kết trong tệp zip đó.
Mở công cụ Trình chỉnh sửa mô hình trong trình duyệt.
Hãy sử dụng một trong các phương pháp sau để thêm tệp vào công cụ xem trước:
Để kéo và thả tệp để xác thực, hãy chọn nhiều tệp glb hoặc glTF và mọi tệp liên kết (hoặc chọn một tệp zip chứa các tệp này) rồi kéo tệp đó vào công cụ xem trước.
Chọn tệp từ công cụ xem trước. Trong công cụ trình xem trước, hãy chọn Scene Viewer > Load File (Trình xem cảnh > Tải tệp). Chọn nhiều tệp glb hoặc glTF và tất cả các tệp liên kết (hoặc một tệp zip chứa những tệp này) rồi nhấp vào Open (Mở).
Lỗi xác thực
Mã lỗi | Mức độ nghiêm trọng | Thông điệp | Các giá trị hiện được hỗ trợ |
---|---|---|---|
INVALID_INPUT_FILE_EXTENSION |
Lỗi | Tệp đầu vào [filename] có đuôi tệp không được trình xác thực hỗ trợ. | ['.glb', '.gltf'] |
REC_INPUT_BINARY_SIZE_EXCEEDED |
Nhắc nhở | Dữ liệu đầu vào do người dùng cung cấp có kích thước nhị phân vượt quá giới hạn do thông số kỹ thuật của Scene Inspector (Trình xem cảnh) đề xuất, giới hạn kích thước đề xuất là [size] MB. | 10 |
MAX_INPUT_BINARY_SIZE_EXCEEDED |
Lỗi | Dữ liệu đầu vào do người dùng cung cấp có kích thước nhị phân vượt quá giới hạn tối đa được hỗ trợ theo thông số kỹ thuật của Scene Viewer là [size] MB. | 15 |
UNSUPPORTED_GLTF_EXTENSION_USED |
Lỗi | Phần mở rộng [ext] trong glTF không được đặc tả của Scene Viewer hỗ trợ. | ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform'] |
ANIMATION_LIMIT_EXCEEDED |
Lỗi | Số lượng ảnh động trong glTF vượt quá giới hạn được đặc tả của Scene Inspector (Trình xem cảnh) hỗ trợ, tối đa [num] ảnh động. | 1 |
MORPH_TARGET_USED |
Lỗi | glTF chứa mục tiêu hình thái không được đặc tả của Scene Inspector (Trình xem cảnh) hỗ trợ. | |
MATERIAL_LIMIT_EXCEEDED |
Nhắc nhở | Số lượng vật liệu trong glTF vượt quá giới hạn do thông số kỹ thuật của Scene Inspector (Trình xem cảnh) đề xuất, tối đa là [num] tài liệu. | 10 |
TEXTURE_RESOLUTION_LIMIT_EXCEEDED |
Nhắc nhở | Độ phân giải của hình ảnh tại chỉ mục [idx] trong glTF vượt quá giới hạn do thông số kỹ thuật của Scene Viewer đề xuất, tức là độ phân giải tối đa [res] x [res]. | 2.048 x 2.048 |
UV_LIMIT_EXCEEDED |
Lỗi | Số lượng UV trên mỗi lưới trong glTF vượt quá giới hạn mà thông số kỹ thuật của Scene Viewer hỗ trợ, tối đa là [num] UV trên mỗi lưới. | 1 |
VERTEX_COLOR_USED |
Lỗi | glTF chứa một màu đỉnh không được thông số kỹ thuật của Scene Inspector (Trình xem cảnh) hỗ trợ. | |
JOINT_LIMIT_EXCEEDED |
Lỗi | Số lượng nút trong glTF vượt quá giới hạn được thông số kỹ thuật của Scene Viewer hỗ trợ, tối đa là [num] nút. | 254 |
TRIANGLE_LIMIT_EXCEEDED |
Nhắc nhở | Số lượng hình tam giác trong glTF vượt quá giới hạn mà thông số kỹ thuật của Scene Inspector (Trình xem cảnh) đề xuất, tối đa là [num] hình tam giác. | 100.000 |
PRIMITIVE_MODE_UNSUPPORTED |
Lỗi | Chế độ gốc [mode] không được đặc tả của Scene Viewer hỗ trợ. | {4 : Danh sách hình tam giác, 5 : Dải hình tam giác, 6 : Quạt tam giác} |
MISSING_PBR_METALLIC_ROUGHNESS |
Thông tin |
Tài liệu tại chỉ mục [idx] bị thiếu thuộc tính pbrMetallicRoughness . Thông số kỹ thuật của Scene Viewer không yêu cầu thuộc tính này nếu sử dụng các yếu tố ánh kim loại và độ nhám. Nếu cả hai giá trị này đều không được sử dụng, thì chất liệu sẽ sử dụng các giá trị mặc định, điều này có thể dẫn đến hành vi ngoài ý muốn.
|