Bir Android uygulaması veya tarayıcıdan etkileşimli 3D modelleri artırılmış gerçeklikle (AR) görüntülemek için Scene Viewer'ı kullanma

Scene Viewer, web sitenizdeki veya Android uygulamanızdaki 3D ve AR deneyimlerini etkinleştiren sürükleyici bir görüntüleyicidir. Android mobil cihaz kullanıcılarının, web'de barındırılan 3D modelleri ortamlarında kolayca önizlemesini, yerleştirmesini, görüntülemesini ve bunlarla etkileşim kurmasını sağlar.

Çoğu Android tarayıcı Scene Viewer'ı destekler. Scene Viewer, 3D ve AR deneyimlerini güvenilir bir şekilde desteklemek için birçok Google iş ortağı tarafından başarıyla uygulanmıştır. Ayrıca, Google Arama'daki bu deneyimleri de destekler.

Uygulama basittir:

  • Web tabanlı deneyimler için web sayfasında yalnızca düzgün biçimlendirilmiş bağlantılar gerekir.

  • Uygulama tabanlı deneyimler için yalnızca birkaç satır Java kodu entegre etmeniz gerekir.

Scene Viewer çalışma zamanı gereksinimleri

Scene Viewer ile artırılmış gerçeklik (AR) deneyimi yaşamak için kullanıcıların:

  • Android 7.0 Nougat (API düzeyi 24) veya sonraki sürümlerin yüklü olduğu ARCore'u destekleyen bir cihaz
  • AR için Google Play Hizmetleri'nin güncel (son) sürümü. Bu hizmet, ARCore'un desteklendiği cihazların büyük çoğunluğuna otomatik olarak yüklenir ve güncel tutulur.
  • Google uygulamasının güncel bir sürümü. Bu uygulama önceden yüklenmiş olarak gelir ve ARCore'un desteklediği cihazların büyük çoğunluğunda otomatik olarak güncel tutulur.

AR için Google Play Hizmetleri'nin veya Google uygulamasının bulunmadığı ya da yüklü sürümlerin çok eski olduğu durumlarda, alternatif bir deneyimi (ör. web sayfası, hata mesajı veya oluşturduğunuz bir yedek deneyim) başlatan bir yedek URL belirtebilirsiniz.

Desteklenen kullanım alanları

Kullanım amacı Önerilen uygulama Avantajları
Bir web sitesindeki veya Android uygulamasındaki düğmeyi ya da bağlantıyı kullanarak 3D modelin yerel AR görünümünü başlatın.

AR için Google Play Hizmetleri cihazda yoksa, modeli Scene Viewer destekli 3D modunda göstermeye sorunsuz bir şekilde geri dönün.
Google Arama paketine yönelik belirgin intent ile Scene Viewer'ı başlatın ve 3D modeli görüntülemek için uygun bir mode ayarı seçin.
  • ar_preferred: Her zaman AR görüntüleyicide başlar ve kullanıcılar manuel olarak 3D görüntüleyiciye geçebilir. AR için Google Play Hizmetleri yoksa 3D görüntüleyicide başlatmaya sorunsuz bir şekilde geri döner.
  • 3d_preferred: Her zaman 3D görüntüleyicide başlar ve kullanıcılar manuel olarak AR görüntüleyiciye geçebilir. AR için Google Play Hizmetleri yoksa kullanıcılar 3D görüntüleyiciden çıkamaz.
  • 3d_only: Her zaman yalnızca 3D görüntüleyicide gösterilir ve kullanıcıların AR görüntüleyiciye geçmesi mümkün değildir.
  • Mümkün olan en geniş cihaz aralığını destekleyin.
  • Artırılmış gerçeklik dışı kullanım alanlarında Scene Viewer'ın yerel 3D moduna otomatik olarak geri döner.
Bir web sitesindeki veya Android uygulamasındaki düğmeyi ya da bağlantıyı kullanarak 3D modelin yerel AR görünümünü başlatın.

AR için Google Play Hizmetleri cihazda yoksa yedek davranışını kontrol edin.
AR için Google Play Hizmetleri (ARCore) için belirgin intent kullanarak Scene Viewer'ı başlatın ve 3B modeli görüntülemek için uygun bir mode ayarı seçin.
  • ar_preferred: Her zaman AR görüntüleyicide başlar ve kullanıcılar manuel olarak 3D görüntüleyiciye geçebilir. AR için Google Play Hizmetleri yoksa Scene Viewer, yapılandırdığınız davranışa geri döner.
  • ar_only: Her zaman yalnızca AR görüntüleyicide gösterilir ve 3D görüntüleyiciye geçiş yapılamaz. AR için Google Play Hizmetleri yoksa yapılandırdığınız davranışa geri döner. Örneğin, kendi tam ekran 3D deneyiminizi başlatabilir veya kullanıcının cihazının henüz AR özelliklerini desteklemediğini belirten bir hata mesajı gösterebilirsiniz.
Kendi 3D model görüntüleyicinizi kullanın veya artırılmış gerçeklik dışı kullanım alanları için kendi tasarımınız olan başka bir yedek yanıt sağlayın.
Web sitenizde 3D modelin satır içi görünümünü barındırın ve kullanıcının tam ekran doğal AR moduna manuel olarak girmesine izin verin. 3D modeli artırılmış gerçeklikte yerel olarak görüntüleyen Scene Viewer'ı başlatmak için <model-viewer> veya başka bir web tabanlı 3D görüntüleyiciyi kullanın.
  • Web sayfasına yerleştirilmiş bir 3D modelden doğrudan artırılmış gerçeklikte Scene Viewer'ı yerel olarak başlatın.
  • Kullanıcılara sahip olduğunuz ve kontrol ettiğiniz bir yüzeyde 3D deneyimi sunun. Kullanıcıların bu deneyimi tercih ettiğini anladığınızda onları daha sürükleyici bir AR deneyimine kademeli olarak geçirme seçeneği de sunabilirsiniz.

Belirgin intent kullanarak Scene Viewer'ı başlatma (3D veya AR)

En geniş Android cihaz yelpazesini desteklemek için Scene Viewer'ı başlatmak üzere açık bir Android intent'i kullanın. Belirgin intent, bir HTML sayfasından veya yerel bir Android uygulamasından tetiklenebilir. Intent, ARCore destekli Android cihazlarda önceden yüklenmiş olarak gelen Google uygulaması tarafından işlenir.

Yapılandırılan amaç parametrelerine ve cihaz özelliklerine bağlı olarak, etkileşimli 3D modeller kullanıcının ortamına yerleştirilebilir veya 3D görüntüleyicide gösterilmeye geri dönebilir.

  • AR için Google Play Hizmetleri cihazda yüklüyse ve güncelse Scene Viewer, modeli AR'ye özgü bir görünümde veya 3D görünümde gösterir.

  • AR için Google Play Hizmetleri yoksa veya güncel değilse Scene Viewer, modeli 3D görünümde göstermeye sorunsuz bir şekilde geri döner.

  • Örneğin, Google uygulaması yüklü olmadığı veya eski bir sürüm olduğu için 3D model görüntülenemiyorsa bunun yerine yedek bir web sayfası görüntülemek için S.browser_fallback_url parametresi kullanılır.

HTML veya Java'dan Scene Viewer'ı başlatma

HTML

HTML'den belirgin intent tetiklemek için aşağıdaki söz dizimini kullanın:

<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

Java'dan belirgin intent'i tetiklemek için aşağıdaki kodu kullanın:

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);

Amaç sürümü oluşturma

Amacın sürümü, arvr.google.com/scene-viewer işaretinden sonraki sürüm numarasıyla belirtilir. Örneğin, ilk sürümde 1.0 sürümü kullanıldı. Daha yeni Scene Viewer özellikleri gerektiğinde, Scene Viewer'ı istediğiniz özelliklere karşılık gelen daha yüksek bir amaç sürümüyle başlatabilirsiniz.

Intent 1.1 sürümünde, doğrudan bir URL'ye değil, bir Android uygulamasında başlatılabilen intent:// bağlantıları için destek eklendi. Scene Viewer'ın bu işlevin başlatıldığında kullanılabilir olmasını ve aksi takdirde başlatılamamasını istiyorsanız Scene Viewer'ı intent://arvr.google.com/scene-viewer/1.1 amaçlı bir niyetle başlatın.

Desteklenen amaç parametreleri

Google Arama paketine yönelik belirgin intent için aşağıdaki parametreler desteklenir.

Amaç Parametresi İzin Verilen Değerler Yorumlar
file (zorunlu) Geçerli bir URL Bu URL, Scene Viewer'a yüklenmesi gereken glTF veya glb dosyasını belirtir. Bu, URL'de kaçış karakteriyle belirtilmelidir.
S.browser_fallback_url (HTML tabanlı amaçlar için zorunlu) Geçerli bir URL Bu, yalnızca web tabanlı uygulamalarda desteklenen bir Google Chrome özelliğidir. Cihazda Google uygulaması yoksa Google Chrome'un yönlendirildiği URL budur.
mode (isteğe bağlı) 3d_preferred (varsayılan) Scene Viewer, modeli 3D modda ve Alanınızda görüntüleyin düğmesiyle gösterir.



AR için Google Play Hizmetleri cihazda yoksa Kendi alanınızda görüntüleyin düğmesi gizlenir.

3d_only AR için Google Play Hizmetleri cihazda yüklü olsa bile Scene Viewer, model 3D modunda gösterilerek başlatılır. Alanınızda görüntüleyin düğmesi hiçbir zaman gösterilmez.

ar_preferred Scene Viewer, giriş modu olarak AR yerel modunda başlatılır. Kullanıcıya Alanınızda görüntüleme ve 3D olarak görüntüleme düğmeleriyle AR ve 3D modları arasında geçiş yapma seçeneği sunulur.



AR için Google Play Hizmetleri yoksa Scene Viewer, giriş modu olarak 3D moduna sorunsuz bir şekilde geri döner.

ar_only Bu değeri kullanırken com.google.ar.core için açık bir Android intent'i üzerinden başlatma yapmanız gerekir.

Not: Google uygulamasına açık Android intent'i aracılığıyla başlatırken ar_only modunu kullanmayın.

link (isteğe bağlı) Geçerli bir URL Harici bir web sayfasının URL'si. Varsa kullanıcı arayüzünde, tıklandığında bu URL'ye yönlendiren bir düğme gösterilir.

title (isteğe bağlı) Geçerli dize Modelin adı. Varsa kullanıcı arayüzünde gösterilir. Ad, 60 karakterden sonra üç nokta ile kısaltılır.

ses (isteğe bağlı) Geçerli bir URL Bir glTF dosyasına yerleştirilmiş ilk animasyonla senkronize edilmiş, döngüye alınmış bir ses parçasının URL'si. Aynı uzunlukta bir animasyon içeren glTF ile birlikte sağlanmalıdır. Mevcutsa model yüklendikten sonra ses döngüye alınır. Bu, URL'de kaçış karakteriyle belirtilmelidir.
resizable (isteğe bağlı) true (varsayılan)

false

false olarak ayarlandığında kullanıcılar, artırılmış gerçeklik deneyiminde modeli ölçeklendiremez. Ölçeklendirme, 3D deneyiminde normal şekilde çalışır.
enable_vertical_placement (isteğe bağlı) false (varsayılan)

true

true olarak ayarlandığında kullanıcılar modeli dikey bir yüzeye yerleştirebilir.

Kullanıcı deneyimi rehberliği

Kullanıcılara mümkün olan en iyi kullanıcı deneyimini sunmak için görünür harekete geçirici mesajların, kullanıcının yakında sürükleyici bir ortama gireceğini belirtmesini öneririz.

3D görüntüleyici deneyimleri için aşağıdaki resimlerden birine benzeyen ve 3D olarak görüntüle etiketli bir harekete geçirici mesaj kullanmanızı öneririz:

AR için Google Play Hizmetleri'ne yönelik belirgin intent kullanarak Scene Viewer'ı başlatma (yalnızca AR modu)

Scene Viewer'daki AR modu, AR için Google Play Hizmetleri tarafından desteklenir.

Sahne Görüntüleyici'de artırılmış gerçekliğin (AR) kullanılabilmesini sağlamak için web sitesinden veya yerel Android uygulamasından com.google.ar.core package aracılığıyla Sahne Görüntüleyici'yi başlatmak üzere açık bir Android intenti kullanabilir ve browser_fallback_url sağlayabilirsiniz. Bu sayede, tüm kullanıcıların Scene Viewer üzerinden doğal bir artırılmış gerçeklik deneyimi yaşamasını veya kendinizin oluşturduğu bir yedek deneyimden yararlanmasını sağlayabilirsiniz. Örneğin, kendi 3D görüntüleyiciniz veya zarif bir hata mesajı gibi yedek deneyimler oluşturabilirsiniz.

HTML'den belirgin intent tetiklemek için aşağıdaki söz dizimini kullanın:

<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>;

Java'dan belirgin intent'i tetiklemek için aşağıdaki kodu kullanın:

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);

Desteklenen amaç parametreleri

AR için Google Play Hizmetleri paketi için belirgin bir intent ile aşağıdaki parametreler desteklenir.

Amaç Parametresi İzin Verilen Değerler Yorumlar
browser_fallback_url (HTML tabanlı amaçlar için zorunlu) Geçerli bir URL Bu özellik yalnızca web tabanlı uygulamalarda desteklenir. AR için Google Play Hizmetleri cihazda bulunmadığında veya güncel olmadığında bu URL'ye yönlendirilir.
mode (isteğe bağlı) ar_only Scene Viewer, 3D modeli her zaman yerel bir AR görünümünde başlatır ve Scene Viewer 3D görüntüleyiciye geçiş için kullanıcı arayüzünü gizler.

AR için Google Play Hizmetleri yoksa Scene Viewer, web tabanlı deneyimler için browser_fallback_url içinde ayarladığınız URL'yi başlatır. Uygulama tabanlı deneyimlerde Scene Viewer, hata mesajı veya kendinizin oluşturduğu başka bir deneyim gibi alternatif bir deneyime geri döner.

ar_preferred Scene Viewer, giriş modu olarak AR yerel modunda başlatılır ve kullanıcılara Alanınızda görüntüleyin ve 3D olarak görüntüleyin düğmeleri aracılığıyla AR ve 3D modları arasında geçiş yapma seçeneği sunar.

AR için Google Play Hizmetleri yoksa Scene Viewer, web tabanlı deneyimler için browser_fallback_url içinde ayarladığınız URL'yi başlatır. Uygulama tabanlı deneyimlerde Scene Viewer, hata mesajı veya kendinizin oluşturduğu başka bir deneyim gibi alternatif bir deneyime geri döner.

   

link (isteğe bağlı) Geçerli bir URL Harici bir web sayfasının URL'si. Varsa kullanıcı arayüzünde, tıklandığında bu URL'ye yönlendiren bir düğme gösterilir.



1.1 sürümünde, Scene Viewer'da intent:// bağlantıları için destek eklendi. Bu sayede, Scene Viewer'daki ziyaret düğmesi doğrudan diğer uygulamaları tetikleyebilecek. Bu özelliğin dikkatli bir şekilde kullanılması ve yalnızca belirli bir amaç için amaç işleyicinin mevcut olduğu garanti edildiğinde belirtilmesi gerektiğini unutmayın.
title (isteğe bağlı) Geçerli dize Modelin adı. Varsa kullanıcı arayüzünde gösterilir. Ad, 60 karakterden sonra üç nokta ile kısaltılır.



1.1 sürümünde, başlık içeriğinin HTML ile stilize edilmesi desteklenmeye başlandı. Bu sürümde, başlık içeriğine istenen miktarda metin eklenebilir. Başlığın URL'de kod dışına alınması gerektiğini unutmayın.
sound (isteğe bağlı) Geçerli bir URL glTF dosyasına yerleştirilmiş ilk animasyonla senkronize edilmiş, döngüye alınmış bir ses parçasının URL'si. Aynı uzunlukta bir animasyon içeren glTF ile birlikte sağlanmalıdır. Mevcutsa ses, model yüklendikten sonra döngüye alınır.
resizable (isteğe bağlı) true (varsayılan)

false

false olarak ayarlandığında kullanıcılar, artırılmış gerçeklik deneyiminde modeli ölçeklendiremez. Ölçeklendirme, 3D deneyiminde normal şekilde çalışır.
disable_occlusion (isteğe bağlı) false (varsayılan)

true

true olarak ayarlandığında sahneye yerleştirilen nesneler her zaman sahnedeki gerçek dünya nesnelerinin önünde görünür. Daha fazla bilgi için [Enable occlusion](/ar/develop/depth#enable_occlusion) başlıklı makaleye bakın.

Kullanıcı deneyimi rehberliği

Kullanıcılara mümkün olan en iyi kullanıcı deneyimini sunmak için bu yönergeleri uygulamanızı öneririz.

  • Artırılmış gerçeklik deneyimlerinde, görünür durumdaki harekete geçirici mesaj, kullanıcının sürükleyici bir ortama girmek üzere olduğunu belirtmelidir.
    Alanınızda görüntüle harekete geçirici mesajını kullanmanızı öneririz:

  • Kullanıcılar cihazlarına AR için Google Play Hizmetleri'ni yüklememiş olabilir. <model-viewer>, yedeklemeyi şu şekilde işler. Bu kod parçasını başlangıç noktası olarak kullanabilirsiniz.

    // 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);
    

Sahne Görüntüleyici'yi başlatmak için <model-viewer> simgesini kullanma

<model-viewer> web bileşenini ar özelliğiyle birlikte ekleyerek web sitenizden Scene Viewer'ı etkinleştirebilirsiniz.

<model-viewer ar
              ar-modes="scene-viewer webxr quick-look"
              alt="A 3D model of an astronaut."
              src="Astronaut.gltf"></model-viewer>

ARCore'u destekleyen bir Android cihazda görüntülendiğinde, ar özelliğiyle <model-viewer> bileşenini içeren bir web sitesinde aşağıdaki örnekte gösterildiği gibi bir düğme görüntülenir.

ar-modes'de scene-viewer modu kullanıldığında, yerel bir AR görünümüne geçilir ve kullanıcı, Scene Viewer'ı kullanarak modeli kendi ortamına yerleştirmeye davet edilir.

AR Destekli Google Play Hizmetleri yoksa bu düğmeye dokunduğunuzda model, <model-viewer>'nın 3D görüntüleyicisinde gösterilir.

<model-viewer> ile ilgili belgelere göz atarak <model-viewer>'ı kullanmaya başlama<model-viewer> hakkında daha fazla bilgi edinebilirsiniz.

Modeller için dosya koşulları

Scene Viewer, modeller için aşağıdaki destek ve sınırlamalara sahiptir.

Dosya biçimi desteği glTF 2.0/glb sürümünde aşağıdaki uzantılar kullanılıyorsa:
  • KHR_materials_unlit
  • KHR_texture_transform
Animasyon
  • İskelet animasyonunu döngüye alma
  • Döngüsel katı animasyon
  • Dönüşüm animasyonunu döngüye alma
Animasyon döngü halinde oynatılır. glTF dosyası birden fazla animasyon içeriyorsa Scene Viewer yalnızca ilk animasyonu oynatır.
Önerilen sınırlar Öğelerin genel performansı, kısıtlamaların ayarlanmasına ve köşe noktaları, malzemeler, doku çözünürlüğü, malzeme başına ağ ve diğer faktörler arasında denge kurulmasına bağlıdır. Öğelerinizi optimize etmek için aşağıdaki yönergeleri kullanın.
  • Üçgen sayısı: Önerilen sınır 100.000 üçgendir ancak en düşük sayıyı hedeflemek Scene Viewer'da yüksek performansı korur. 30.000 ila 50.000 ideal bir aralıktır.
  • Materyal sayısı: Önerilen sınır 10 materyaldir. Bunlardan ikisi alfa olabilir. Öğenin iyi performans göstermesini sağlamak için mümkün olan en düşük sayıyı hedefleyin.
  • Malzeme başına ağ: 1
  • Maksimum doku çözünürlüğü: 2048 × 2048
  • Kemik (ağırlıklı olmayan eklemler dahil): 254 (kesin sınır)
  • Köşe başına kemik ağırlığı sınırı: 4 (kesin sınır)
  • UV: Ağ başına 1 UV (kesin sınır)
  • Model boyutu: 10 MB (Daha büyük modeller, kötü bir kullanıcı deneyimine neden olabilir.)
Shadow desteği Bir nesne yerleştirilirken sert gölgeler Scene Viewer tarafından otomatik olarak oluşturulur. Bu nedenle, gölgeleri modelinize yerleştirmenizi önermeyiz.
Doku desteği
  • PNG biçimi: PNG-24, dizine eklenmiş PNG-8.
    Şeffaflık olmadığında boyutlarını küçülttükleri için JPG'ler tercih edilir.
  • Renk alanı: sRGB
Malzeme PBR
Dosya yükleme HTTPS
Sahne
  • Eksen: sağ elini kullananlar için, şu özelliklere sahip:
    • +X doğru
    • +Y yukarı
    • -Z, başlangıç noktasından ileriye doğru yönelir (başka bir deyişle, bir öğenin "önü" +Z'ye bakmalıdır).
  • Ölçek: 1 birim = 1 metre (modelin AR'ye gerçek ölçekte yerleştirilmesini sağlamak için glTF spesifikasyonunda tanımlandığı gibi)

3D modellerinizi doğrulamak için önizleme aracını kullanma

3D model dosyanızın Sahne Görüntüleyici'de düzgün şekilde gösterilmesini sağlamak için bilgisayarınızdaki dosyaları doğrulamak üzere online önizleme aracımızı kullanın.

3D modelinizi doğrulama

Önizleme aracı, bir modeli doğrulamak için bir glb veya glTF dosyası, ilişkili tüm resim ve bin dosyaları ve isteğe bağlı bir ses dosyası gerektirir. Ses dosyası, animasyon 0 ile birlikte döngüye alınır.

Dosyaları tek tek seçebilir veya isteğe bağlı olarak glb ya da glTF dosyasını ve ilişkili dosyalarını bir zip dosyasına koyabilirsiniz. (ZIP dosyası yöntemi, ses dosyalarını desteklemez.)

3D modelinizi doğrulamak için:

  1. Online önizleme aracını tarayıcıda açın.

  2. Dosyaları önizleme aracına eklemek için aşağıdaki yöntemlerden birini kullanın:

    • Sürükle ve bırak. Bir glb veya glTF dosyası ile ilişkili tüm dosyaları (ya da bu dosyaları içeren bir zip dosyası) seçin ve seçilen dosyaları veya zip dosyasını önizleme aracına sürükleyin.

    • Önizleme aracından Önizleme aracında Scene Viewer > Load File'ı (Sahne Görüntüleyici > Dosyayı Yükle) seçin. Bir glb veya glTF dosyası ile ilişkili tüm dosyaları (ya da bu dosyaları içeren bir ZIP dosyası) seçip 'ı tıklayın.

3D modelinizi oluşturan dosyaları önizleme aracına yükledikten sonra, tarayıcının alt kısmındaki konsolda hata mesajları da dahil olmak üzere sonuçlar gösterilir.

Doğrulama için 3D modeller ekleme

3D modeli doğrulamak için 3D modeli oluşturan dosyaları Model Düzenleyici aracımıza ekleyin.

Önizleme aracının bir modeli doğrulayabilmesi için modelin GLB veya glTF dosyası, ilişkili tüm resim ve bin dosyaları ve isteğe bağlı bir ses dosyası gerekir. Tek tek dosyaları çoklu seçebilir veya tek bir ZIP dosyası ekleyebilirsiniz.

Zip dosyası eklerken önizleme aracı, bulduğu ilk glb veya glTF dosyasını ve bu zip dosyasındaki ilişkili resim ve bin dosyalarını yükler.

  1. Model Düzenleyici aracını bir tarayıcıda açın.

  2. Dosyaları önizleme aracına eklemek için aşağıdaki yöntemlerden birini kullanın:

    • Doğrulama için dosyaları sürükleyip bırakmak üzere glb veya glTF dosyasını ve ilişkili tüm dosyaları çoklu seçin (ya da bu dosyaları içeren bir zip dosyası seçin) ve önizleme aracına sürükleyin.

    • Önizleme aracından dosyaları seçin. Önizleme aracında Scene Viewer > Load File'ı (Sahne Görüntüleyici > Dosyayı Yükle) seçin. glb veya glTF dosyasını ve ilişkili tüm dosyalarını (ya da bu dosyaları içeren bir zip dosyası) çoklu seçin ve 'ı tıklayın.

Doğrulamayla ilgili hatalar

Hata Kodu Önem derecesi Mesaj Şu anda desteklenen değerler
INVALID_INPUT_FILE_EXTENSION Hata Giriş dosyası [filename], doğrulayıcı tarafından desteklenmeyen bir dosya uzantısına sahip. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED Uyarı Sağlanan kullanıcı girişi, Scene Viewer spesifikasyonu tarafından önerilen [size] MB'lık sınırı aşan bir ikili program boyutuna sahip. 10
MAX_INPUT_BINARY_SIZE_EXCEEDED Hata Sağlanan kullanıcı girişi, Scene Viewer spesifikasyonu tarafından desteklenen maksimum [size] MB'lık sınırı aşan bir ikili program boyutuna sahip. 15
UNSUPPORTED_GLTF_EXTENSION_USED Hata glTF dosyasındaki [ext] uzantısı, Scene Viewer spesifikasyonu tarafından desteklenmiyor. ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED Hata glTF dosyasındaki animasyonların sayısı, Scene Viewer spesifikasyonu tarafından desteklenen sınırı (maksimum [num] animasyon) aşıyor. 1
MORPH_TARGET_USED Hata glTF dosyası, Scene Viewer spesifikasyonu tarafından desteklenmeyen bir dönüşüm hedefi içeriyor.
MATERIAL_LIMIT_EXCEEDED Uyarı glTF dosyasındaki materyallerin sayısı, Scene Viewer spesifikasyonu tarafından önerilen sınırı (maksimum [num] materyal) aşıyor. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED Uyarı glTF dosyasında [idx] dizinindeki resmin çözünürlüğü, Scene Viewer spesifikasyonu tarafından önerilen sınırı (maksimum [res] x [res] çözünürlük) aşıyor. 2048 x 2048
UV_LIMIT_EXCEEDED Hata glTF dosyasındaki ağ başına UV sayısı, Scene Viewer spesifikasyonu tarafından desteklenen sınırı (ağ başına maksimum [num] UV) aşıyor. 1
VERTEX_COLOR_USED Hata glTF dosyası, Scene Viewer spesifikasyonu tarafından desteklenmeyen bir köşe rengi içeriyor.
JOINT_LIMIT_EXCEEDED Hata glTF dosyasındaki birleşim sayısı, Scene Viewer spesifikasyonu tarafından desteklenen sınırı (maksimum [num] birleşim) aşıyor. 254
TRIANGLE_LIMIT_EXCEEDED Uyarı glTF dosyasındaki üçgenlerin sayısı, Scene Viewer spesifikasyonu tarafından önerilen sınırı (maksimum [num] üçgen) aşıyor. 100.000
PRIMITIVE_MODE_UNSUPPORTED Hata [mode] temel modu, Scene Viewer spesifikasyonu tarafından desteklenmiyor. {4 : Üçgen Listesi, 5 : Üçgen Şeridi, 6 : Üçgen Yelpazesi}
MISSING_PBR_METALLIC_ROUGHNESS Bilgi [idx] dizinindeki materyalin pbrMetallicRoughness özelliği eksik. Onun yerine metalik ve pürüzlülük faktörleri kullanılırsa Scene Viewer için bu özellik gerekmez. Bunların hiçbiri kullanılmazsa materyal için varsayılan değerler kullanılır, bu da istenmeyen davranışa neden olabilir.