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 sitenizden veya Android uygulamanızdan 3D ve AR deneyimlerine olanak tanıyan etkileyici bir görüntüleyicidir. Android mobil cihaz kullanıcılarının kendi ortamlarında kolayca önizleme, yerleştirme, görüntüleme ve bu modellerle etkileşime geçmelerine olanak tanır.

Ç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 için bu deneyimleri destekler.

Uygulanması kolaydır:

  • Web tabanlı deneyimlerde, web sayfasında yalnızca düzgün şekilde biçimlendirilmiş bağlantılar gerekir.

  • Uygulama tabanlı deneyimler yalnızca birkaç satırlık Java kodunun entegre edilmesini gerektirir.

Scene Viewer çalışma zamanı gereksinimleri

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

  • Android 7.0 Nougat (API Düzeyi 24) veya sonraki sürümleri çalıştıran ARCore destekli bir cihaz.
  • AR için Google Play Hizmetleri'nin güncel (yeni) bir sürümü. Bu hizmet, ARCore destekli çok sayıda cihazda otomatik olarak yüklenir ve güncel tutulur.
  • Google uygulamasının güncel bir sürümüdür. Önceden yüklenmiş olarak gelen bu uygulama, ARCore destekli 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 durumları sağlamak amacıyla web sayfası, bir hata mesajı veya oluşturduğunuz yedek deneyim gibi alternatif bir deneyim başlatan bir yedek URL belirtebilirsiniz.

Desteklenen kullanım alanları

Amaçlanan kullanım alanı Önerilen uygulama Avantajları
Bir web sitesindeki veya Android uygulamasındaki bir düğmeden ya da bağlantıdan 3D modelin yerel AR görünümünü başlatın.

AR için Google Play Hizmetleri cihazda yoksa arkanıza yaslanın ve modeli Scene Viewer destekli 3D modunda gösterin.
Google Arama paketi için açık bir intent kullanarak Scene Viewer'ı başlatın ve 3D modeli görüntülemek için uygun bir mode ayarı seçin.
  • ar_preferred: Her zaman artırılmış gerçeklik (AR) görüntüleyicide başlar ve kullanıcılar 3D görüntüleyiciye manuel olarak geçebilir. AR için Google Play Hizmetleri mevcut değilse 3D görüntüleyicide başlangıç seviyesine sorunsuzca geri döner.
  • 3d_preferred: Her zaman 3D görüntüleyicide başlar ve kullanıcılar bir AR görüntüleyiciye manuel olarak geçebilir. AR için Google Play Hizmetleri mevcut değilse kullanıcılar 3D görüntüleyiciden geçiş yapamaz.
  • 3d_only: Her zaman yalnızca 3D görüntüleyicide gösterilir ve kullanıcıların artırılmış gerçeklik gözlüğüne geçmesine izin verilmez.
  • Mümkün olan en geniş cihaz yelpazesini destekleyin.
  • Artırılmış gerçeklik (AR) dışı kullanım alanları için otomatik olarak Scene Viewer'ın yerel 3D moduna geçiş yapılır.
Bir web sitesindeki veya Android uygulamasındaki bir düğmeden ya da bağlantıdan 3D modelin yerel AR görünümünü başlatın.

Cihazda AR için Google Play Hizmetleri yoksa yedek davranışı kontrol edin.
AR için Google Play Hizmetleri'ne (ARCore) açık bir niyet kullanarak 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 bir 3D görüntüleyiciye manuel olarak geçebilir. AR için Google Play Hizmetleri mevcut değilse Scene Viewer, yapılandırdığınız davranışa geri döner.
  • ar_only: 3D görüntüleyiciye geçme olanağı olmadan her zaman yalnızca AR görüntüleyicide gösterilir. AR için Google Play Hizmetleri mevcut değilse 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 kolay bir hata mesajı gösterebilirsiniz.
Kendi 3D model görüntüleyicinizi kullanın veya AR dışı kullanım alanları için kendi tasarımınız başka bir yedek yanıt sağlayın.
Web sitenizde bir 3D modelin satır içi görünümünü barındırın ve kullanıcının tam ekran yerel AR moduna manuel olarak girmesini sağlayın. 3D modeli artırılmış gerçeklikte (AR) yerel olarak görüntüleyecek şekilde Scene Viewer'ı başlatmak için <model-viewer> veya başka bir web tabanlı 3D görüntüleyiciyi kullanın.
  • Scene Viewer'ı doğrudan bir web sayfasına yerleştirilmiş 3D modelden artırılmış gerçeklikte (AR) yerel olarak başlatın.
  • Kullanıcılara, sahip olduğunuz ve kontrol ettiğiniz bir yüzeyde 3D deneyim sunun. Amaçlarını anladığınızda onları daha etkileyici bir AR deneyimine kademeli olarak geçirme seçeneği sunun.

Açık bir amaç (3D veya AR) kullanarak Scene Viewer'ı başlatma

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

Yapılandırılmış 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örüntülenmeye yedeklenebilir.

  • Cihazda AR için Google Play Hizmetleri varsa ve güncelse Scene Viewer, modeli artırılmış gerçeklik (AR) yerel görünümünde veya 3D görünümünde gösterir.

  • AR için Google Play Hizmetleri mevcut değilse veya güncel değilse Sahne Görüntüleyici, modeli sorunsuz bir şekilde 3D görünümde gösterir.

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

Scene Viewer'ı HTML veya Java'dan başlatın

HTML

Açık amacı HTML'den 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 açık 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

Amaç sürümü, arvr.google.com/scene-viewer tarihinden sonraki sürüm numarasıyla belirtilir. Örneğin, ilk sürümde 1.0 sürümü kullanılmıştır. Daha yeni Scene Viewer özellikleri gerektiğinde, Scene Viewer'ı ihtiyacınız olan özelliklere karşılık gelen daha yüksek amaca sahip bir sürümle başlatabilirsiniz.

Amaç sürümü 1.1, URL yerine doğrudan bir Android uygulamasında başlatılabilen intent:// bağlantıları için destek ekledi. Sahne Görüntüleyici'nin bu işlevin lansman sırasında kullanılabilir olduğunu garanti etmesini ancak başka bir şekilde başlatamazsanız, sahne görüntüleyiciyi intent://arvr.google.com/scene-viewer/1.1 amacıyla başlatın.

Desteklenen intent parametreleri

Google Arama paketine yapılan açık bir niyet için aşağıdaki parametreler desteklenir.

Amaç Parametresi İzin Verilen Değerler Yorum sayısı
file (zorunlu) Geçerli bir URL Bu URL, Scene Viewer'a yüklenmesi gereken glTF veya glb dosyasını belirtir. Bu, URL çıkışlı olmalıdır.
S.browser_fallback_url (HTML tabanlı amaçlar için gereklidir) Geçerli bir URL Bu, yalnızca web tabanlı uygulamalar için desteklenen bir Google Chrome özelliğidir. Google uygulaması cihazda yoksa Google Chrome'un gittiği URL budur.
mode (isteğe bağlı) 3d_preferred (varsayılan) Scene Viewer, Alanınızda görüntüleyin düğmesiyle modeli 3D modunda görüntüler.



AR için Google Play Hizmetleri'nde yoksa Alanınızda görüntüleyin düğmesi gizlenir.

3d_only Cihazda AR için Google Play Hizmetleri bulunuyor olsa bile, Scene Viewer 3D modda görüntülenen modelle 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 artırılmış gerçeklik (AR) yerel modunda açılır. Kullanıcıya, Alanınızda görüntüleyin ve 3D olarak görüntüle düğmeleri aracılığıyla AR ve 3D modları arasında geçiş yapma seçeneği sunulur.



AR için Google Play Hizmetleri mevcut değilse Scene Viewer, giriş modu olarak sorunsuz bir şekilde 3D moduna geçer.

ar_only Bu değeri kullanırken com.google.ar.core için açık bir Android amacı aracılığıyla başlatmalısınız.

Not: Google uygulamasına açık Android amacı aracılığıyla başlarken 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'yi hedefleyen bir düğme görüntülenir.

title (isteğe bağlı) Geçerli dize Modelin adı. Varsa kullanıcı arayüzünde görüntülenir. 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 edilen döngüsel ses parçasının URL'si. Eşleşen uzunlukta bir animasyona sahip glTF ile birlikte sağlanmalıdır. Varsa model yüklendikten sonra ses döngüye alınır. Bu, URL çıkışlı olmalıdır.
resizable (isteğe bağlı) true (varsayılan)

false

false olarak ayarlandığında kullanıcılar, modeli artırılmış gerçeklik deneyiminde ö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 olan harekete geçirici mesajların kullanıcının etkileyici bir ortama girmek üzere olduğunu yansıtmasını öneririz.

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

AR için Google Play Hizmetleri'ne açık bir niyet kullanarak Scene Viewer'ı başlatın (yalnızca AR modu)

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

Scene Viewer'da AR'nin kullanılabildiğinden emin olmak için bir web sitesinden veya yerel Android uygulamasından açık Android amacı kullanarak com.google.ar.core package aracılığıyla Scene Viewer'ı başlatabilir ve bir browser_fallback_url sağlayabilirsiniz. Bu şekilde, tüm kullanıcıların Scene Viewer aracılığıyla yerel bir AR deneyimine veya kendi oluşturduğunuz bir yedek deneyime sahip olmasını sağlayabilirsiniz. Örneğin, kendi 3D görüntüleyiciniz veya kontrollü bir hata mesajı gibi yedek deneyimler oluşturabilirsiniz.

Açık amacı HTML'den 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 açık 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 intent parametreleri

Aşağıdaki parametreler, AR için Google Play Hizmetleri paketine açık bir intent için desteklenir.

Amaç Parametresi İzin Verilen Değerler Yorum sayısı
browser_fallback_url (HTML tabanlı amaçlar için gereklidir) Geçerli bir URL Bu yalnızca web tabanlı uygulamalar için desteklenir. AR için Google Play Hizmetleri cihazda yoksa veya güncel değilse cihazın gittiği URL budur.
mode (isteğe bağlı) ar_only Scene Viewer, 3D modeli her zaman yerel 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 mevcut değilse Scene Viewer, web tabanlı deneyimler için browser_fallback_url içinde ayarladığınız URL'yi açar. Uygulama tabanlı deneyimlerde Scene Viewer, hata mesajı veya kendi oluşturduğunuz başka bir deneyim gibi alternatif bir deneyime döner.

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

AR için Google Play Hizmetleri mevcut değilse Scene Viewer, web tabanlı deneyimler için browser_fallback_url içinde ayarladığınız URL'yi açar. Uygulama tabanlı deneyimlerde Scene Viewer, hata mesajı veya kendi oluşturduğunuz başka bir deneyim gibi alternatif bir deneyime 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'yi hedefleyen bir düğme görüntülenir.



1.1 sürümü, Scene Viewer ziyaret düğmesinin doğrudan diğer uygulamalarda tetiklenmesini sağlamak için Scene Viewer'a intent:// bağlantıları için destek ekledi. Bunun dikkatli bir şekilde kullanılması ve yalnızca bir amaç işleyicinin belirli bir amaç için 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örüntülenir. Ad, 60 karakterden sonra üç nokta ile kısaltılır.



1.1 sürümü, başlık içeriğinin HTML stilini belirleme desteği ekledi ve isteğe bağlı miktarda metne izin verildi. Başlığın URL çıkışlı olması gerektiğini unutmayın.
sound (isteğe bağlı) Geçerli bir URL Bir glTF dosyasına yerleştirilmiş ilk animasyonla senkronize edilen döngüsel ses parçasının URL'si. Eşleşen uzunlukta bir animasyona sahip glTF ile birlikte sağlanmalıdır. Varsa 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, modeli artırılmış gerçeklik deneyiminde ö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 nesnelerin önünde görünür. Daha fazla bilgi için [Kapanmayı etkinleştirme](/ar/develop/deeplink#enable_occlusion) sayfasını inceleyin.

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 harekete geçirici mesaj, kullanıcının etkileyici bir ortama girmek üzere olduğunu belirtmelidir. Alanınızda görüntüleyin ifadesini içeren harekete geçirici mesajı kullanmanızı öneririz:

  • Kullanıcıların cihazlarında AR için Google Play Hizmetleri yüklü olmayabilir. <model-viewer>'in yedeği nasıl ele aldığı aşağıda açıklanmıştır. Başlangıç noktası olarak bu kod parçasını 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);
    

Scene Viewer'ı başlatmak için <model-viewer> kullanılıyor

<model-viewer> web bileşenini ar özelliğiyle ekleyerek Scene Viewer'ı web sitenizden 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 destekli bir Android cihazda görüntülendiğinde, ar özelliğine sahip <model-viewer> bileşenini içeren bir web sitesi aşağıdaki örnekte gösterildiği gibi bir düğme görüntüler.

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

AR özellikli Google Play Hizmetleri yoksa bu düğmeye dokunduğunuzda model, <model-viewer> adlı kullanıcının 3D görüntüleyicisinde görüntülenir.

<model-viewer> hizmetini kullanmaya nasıl başlayacağınızla ilgili daha fazla bilgi için <model-viewer> belgelerine bakın.

Modeller için dosya gereksinimleri

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

Dosya biçimi desteği glTF 2.0/glb, aşağıdaki uzantıları kullanarak:
  • KHR_materials_unlit
  • KHR_texture_transform
Animasyon
  • Döngü halinde iskelet animasyonu
  • Döngüsel sabit animasyon
  • Dönüşüm animasyonunu döngüye alma
Animasyon bir 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 belirleyip köşeler, malzemeler, doku çözünürlüğü, malzeme başına örgü ve diğer faktörler arasında denge kurmaya bağlıdır. Öğelerinizi optimize etmek için aşağıdaki kurallardan yararlanın.
  • Üçgen sayısı: Önerilen sınır 100.000 üçgendir ancak en düşük sayı hedeflendiğinde Scene Viewer'da yüksek performans sağlanır. 30.000 ila 50.000 ideal bir aralıktır.
  • Malzeme sayısı: Önerilen sınır, ikisi alfa olabilecek 10 malzemedir. Öğenin iyi performans göstermeye devam etmesi için mümkün olan en düşük sayıyı hedefleyin.
  • Malzeme başına örgü: 1
  • Maksimum doku çözünürlüğü: 2048 × 2048
  • Kemik (ağırlıklı olmayan eklemler dahil): 254 (sert sınır)
  • Köşe sınırı başına kemik ağırlıkları: 4 (sabit 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.)
Gölge desteği Bir nesne yerleştirilirken sert gölgeler Scene Viewer tarafından otomatik olarak oluşturulur. Bu nedenle, modelinize gölge eklememenizi öneririz.
Doku desteği
  • PNG biçimi: PNG-24, dizine eklenmiş PNG-8.
    JPG'ler, boyutu küçülttüğü için şeffaflığın olmadığı durumlarda tercih edilir.
  • Renk alanı: sRGB
Malzeme PBR
Dosya yükleniyor HTTPS
Sahne
  • Eksen: Şu özelliklere sahip sağ elle:
    • +X doğru
    • +Y arttı
    • -Z, kaynaktan ileri doğru işaret eder (diğer bir deyişle, bir öğenin "önü" +Z'ye dönük olmalıdır)
  • Ölçek: 1 birim = 1 metre (modelin gerçek ölçekte AR teknolojisine yerleştirilmesi için glTF spesifikasyonunda tanımlandığı gibi)

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

3D model dosyanızın Scene Viewer'da düzgün bir şekilde gösterildiğinden emin olmak için bilgisayarınızdaki dosyaları doğrulamak üzere online önizleme aracımızı kullanın.

3D modelinizi doğrulama

Önizleme aracının bir modeli doğrulamak için bir glb veya glTF dosyasına, ilişkilendirilmiş tüm resim ve bölme dosyalarına ve isteğe bağlı bir ses dosyasına ihtiyacı vardır. Ses dosyası, animasyon 0 ile birlikte döngüye girer.

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

3D modelinizi doğrulamak için:

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

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

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

    • Önizleme aracından. Önizleme aracında Scene Viewer > Dosya Yükle'yi seçin. Bir glb veya glTF dosyasını ve ilişkili tüm dosyalarını (ya da bu dosyaları içeren bir zip dosyasını) seçin ve 'ı tıklayın.

3D modelinizi içeren dosyaları önizleme aracına yükledikten sonra tarayıcının alt kısmındaki bir konsolda tüm hata mesajlarıyla birlikte sonuçlar görüntülenir.

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.

Önizleyici, bir modeli doğrulamak için modelin glb veya glTF dosyasına, ilişkili tüm resim ve bölme dosyalarına ve isteğe bağlı bir ses dosyasına ihtiyaç duyar. Dosyaları tek tek birden fazla seçebilir veya tek bir zip dosyası ekleyebilirsiniz.

Bir zip dosyası eklerken, önizleyici bulduğu ilk glb veya glTF'nin yanı sıra bu zip dosyasındaki ilişkili resmi ve bölme dosyalarını yükler.

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

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

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

    • Önizleme aracından dosya seçin. Önizleme aracında Scene Viewer > Dosya Yükle'yi seçin. glb veya glTF dosyasını ve ilişkili tüm dosyalarını (veya bu dosyaları içeren bir zip dosyasını) çoklu seçim yapın ve 'ı tıklayın.

Doğrulamayla ilgili hatalar

Hata Kodu Önem derecesi Message Desteklenen Mevcut Değerler
INVALID_INPUT_FILE_EXTENSION Hata Girdi dosyası [dosya adı], doğrulayıcı tarafından desteklenmeyen bir dosya uzantısına sahip. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED Uyarı Sağlanan kullanıcı girdisi, 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şinde, Scene Viewer spesifikasyonu tarafından desteklenen maksimum [size] MB'lık sınırı aşan bir ikili program boyutu var. 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 [sayı] 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 [sayı] materyal) aşıyor. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED Uyarı glTF içinde [idx] dizinindeki resmin çözünürlüğü, Scene Viewer spesifikasyonu tarafından önerilen sınırı ([res] x [res]) 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 [sayı] 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 mod, Scene Viewer spesifikasyonu tarafından desteklenmiyor. {4 : Üçgen Liste, 5 : Üçgen Şerit, 6 : Üçgen Vantilatör}
MISSING_PBR_METALLIC_ROUGHNESS Bilgi [idx] dizinindeki malzemede pbrMetallicRoughness özelliği eksik. Bunun 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 ve bu durum istenmeyen davranışlara neden olabilir.