Sık Sorulan Sorular

1. Filigran ve AppKey

Neden: SDK v0.5.0 sürümünden itibaren sol alt köşede varsayılan olarak bir filigran görüntülenir.

Çözüm: Bir AppKey almak için satış ekibiyle iletişime geçin, ardından filigranı kaldırmak için LCCRender.load() içindeki appKey parametresini ayarlayın.

2. Babel Projelerinde SDK Entegrasyon Hatası

Neden: SDK, modern tarayıcı sözdizimini kullanır. Babel bunu eski sözdizimine derleyebilir ve bu durum çalışma zamanı hatalarına veya derleme başarısızlıklarına yol açabilir.

Çözüm:

1. Babel'i, SDK dosyalarını derlemenin dışında bırakacak şekilde yapılandırın.
2. Veya derlemeyi atlamak için SDK dosyasını bir <script> etiketiyle ekleyin:

<script src="./sdk.js"></script>

Ekledikten sonra yüklemek için LCC.LCCRender kullanın.

3. LCC Modeli Three.js Motorunda Görünmüyor

Aşağıdaki sorun giderme adımlarını izleyin:

1. Hata mesajları için tarayıcı konsolunu kontrol edin (ör. dosya bulunamadı).
2. dataPath içindeki dosyalara erişilebildiğini ve indirilebildiğini doğrulayın.
3. Kameranın far düzlemi değerinin yeterince büyük olup olmadığını kontrol edin; model kamera görüş hacminin dışında kalmış olabilir.
4. LCCRender.update() işlevinin görüntüleme döngüsünde çağrıldığını doğrulayın.

Yukarıdakiler sorunu çözmezse teknik destek ekibiyle iletişime geçebilir veya forumda sorabilirsiniz.

4. CesiumJS'de 3D Tile Modeli LCC Modeli Tarafından Örtülüyor

Neden: Varsayılan olarak LCC modeli derinlik tamponuna yazar ve derinlik testi işlevi her zaman geçecek şekilde (ALWAYS) ayarlanmıştır. Pass.CESIUM_3D_TILE görüntüleme kuyruğunda 3D Tiles, LCC modelinden önce yüklenirse LCC modelinin derinliği tarafından üzerine yazılır.

Çözüm:

• 3D Tile modelini LCCRender.load() işlevinin başarı geri çağrısı içinde yükleyin.
• Veya her ikisi de yüklendikten sonra LCC modelinin görüntüleme sırasını öne almak için lccObject.lowerToBottom() çağrısı yapın.

5. CesiumJS Eski Sürüm Desteği

Neden: Cesium v1.102 ve sonraki sürümler varsayılan olarak WebGL2 kullanır, önceki sürümler ise varsayılan olarak WebGL1 kullanır. Web SDK, WebGL1'i desteklemez; bu nedenle WebGL2 zorunlu olarak etkinleştirilmelidir.

Çözüm: WebGL2'yi zorunlu olarak etkinleştirin. Desteklenen en düşük sürüm Cesium v1.67'dir.

const viewer = new Cesium.Viewer("cesiumContainer", {
    orderIndependentTranslucency: false, // Disable order-independent translucency
    useDefaultRenderLoop: true,
    resolutionScale: window.devicePixelRatio,
    contextOptions: {
        webgl2: true, // Force WebGL 2.0
        requestWebgl2: true
    }
});

6. Donanım İyi Olmasına Rağmen Görüntüleyici Takılıyor

Neden: Birden fazla GPU'lu bilgisayarlarda (ör. Intel tümleşik GPU + NVIDIA ayrık GPU) Windows varsayılan olarak tümleşik GPU'yu seçebilir ve bu durum görüntülemede takılmaya yol açar.

Çözüm:

1. Bilgisayarın güç modunu "High Performance" olarak ayarlayın.
2. NVIDIA Control Panel'de tarayıcının ayrık GPU'yu kullanmasını seçin.
3. Windows Settings → Display → Graphics bölümünde tarayıcının "High performance" GPU'yu kullanmasını seçin.

Yeni yapılandırmanın geçerli olması için ayarları tamamladıktan sonra tarayıcıyı yeniden başlatın.

7. Donanım Yeterli Olmasına Rağmen Görüntüleme Takılıyor

3DGS görüntüleme yüksek kaynak gerektirir. Gerekli işlem kaynaklarını boşaltmak için 3D düzenleyiciler, LCC yeniden oluşturma görevleri, HD video oynatma, yüksek hızlı indirmeler ve video akışı gibi kaynak tüketen uygulamaları kapatın.

8. Aynı Dizüstü Bilgisayarda Tutarsız Performans

Aynı dizüstü bilgisayarda farklı zamanlarda sahnelerde gezinirken tutarsız performans yaşıyorsanız (bazen akıcı, bazen takılan), neden büyük olasılıkla harici bir güç kaynağının bağlı olup olmamasıdır. Pille çalışırken dizüstü bilgisayar, CPU ve GPU performansını düşüren güç tasarrufu stratejileri uygular ve bu durum takılmaya yol açabilir. 3DGS sahnelerine göz atarken harici bir güç kaynağı kullanmanız önerilir.