MikroProfil

MikroProfil, Roblox Stüdyosu ve Roblox istemcisinde bir performans optimizasyon ve sorun giderme aracıdır. Bir kare sırasında animasyon, fizik güncelleme, betik çalıştırma ve geometri görüntüleme gibi motor görevleri için ayrıntılı, görsel zamanlama bilgileri sağlar. Hangi görevlerin hangi karede çalıştığını, bu görevlerin ne kadar sürdüğünü ve bir kare zaman hedefinizi kaçırıp kaçırmadığınızı belirleyebilirsiniz.

Kare süreleri

MikroProfil’i kullanmak için kare süresi ve kare hızı arasındaki ilişkiyi anlamalısınız.

• Kare süresi, bir karenin ekranda görünmesi için geçen süre olup, genellikle milisaniye cinsinden ölçülür.
• Kare hızı, ekranda görüntülenen kare sayısı olup, genellikle saniyedeki kare cinsinden (FPS) ölçülür.

Daha düşük kare süreleri, daha yüksek kare hızı anlamına gelir. 1.000 milisaniyeyi (1 saniye) kare süresine bölerek kare hızını öğrenebilirsiniz.

Ancak, akıcı bir oyun deneyimi için yalnızca yüksek bir kare hızına sahip olmak yeterli değildir. Tutarlı kare sürelerine ihtiyacınız var. Örneğin, eğer 10 milisaniyede 59 kare ve 410 milisaniyede bir kare geldiğinde, oyuncular büyük, rahatsız edici bir sarsıntıyı algılar, oysa oyun 60 FPS'de çalışıyordur. Tüm karelerin yaklaşık olarak aynı miktarda süreyle görüntülenmesi durumunda, oyununuz bu tutarlılık sayesinde algısal olarak daha akıcı olacaktır, özellikle düşük kare hızlarında.

MikroProfil, tamamen kare süresine odaklanır. Amacı, kare süresi zirvelerini ve bunların nedenlerini belirlemenize yardımcı olmaktır.

MikroProfil’i Açma

MikroProfil’i açma süreci platforma göre değişir:

• Mobil istemcide, Ayarlar menüsünü açın ve MikroProfil’i Açık konumuna getirin. Ardından, aynı ağda bir geliştirme makinesinden web tarayıcınızı kullanarak sağlanan IP adresine ve porta gidin.

  

  Bu ekran görüntüsü 172.18.56.105 IP adresini ve 1338 portunu gösteriyor, bu yüzden 172.18.56.105:1338 adresine gitmelisiniz. Cihazınızın ağ yapılandırmasına bağlı olarak, birden fazla IP adresi görebilirsiniz. Birisi işe yaramazsa, diğerini deneyin.

  Varsayılan olarak, MikroProfil web arayüzü, mobil cihazınızdan alınan en son 30 kareyi gösterir. Daha büyük bir kare seti için URL'ye bir kesme ve bir rakam ekleyin, örneğin 172.18.56.105:1338/90. Yeni bir kare seti almak için Tekrar yakala düğmesini kullanın.

• Masaüstü istemcide, CtrlF6 (⌘F6) tuşlarına basın.

• Stüdyo’da, CtrlF6 (⌘F6) tuşlarına basın.

Genel olarak, mobil istemci oyununuzu profil çıkarmak için en iyi yerdir. Roblox’ta çoğu oyuncu telefon ve tablet kullanmaktadır ve bu cihazlar performanslarını sınırlayan ciddi termal ve güç kısıtlamalarına sahiptir. Oyununuz orta düzey bir Android tablet üzerinde iyi çalışıyorsa, büyük olasılıkla bir oyun masaüstünde çok daha iyi performans gösterecektir.

MikroProfil Temelleri

MikroProfil'in iki ana bileşeni vardır: kare süresi çubuk grafiği ve ayrıntılı görev zaman çizelgesi.

• Kare süresi grafiği, arayüzün üst kısmında yer alır ve her karenin render edilmesi için geçen süreyi gösterir. Daha yüksek çubuklar daha uzun kare süreleri anlamına gelir.
• Zaman çizelgesi, çerçeve süresinde çalışan tüm bireysel görevleri gösterir. Daha geniş çubuklar daha uzun süren görevleri temsil eder.

MikroProfil'deki tipik bir iş akışı, kare süresi grafiğini kullanarak bir zirve (daha yüksek bir çubuk) istediğinizde, ardından zaman çizelgesini kullanarak bu zirveye neden olan görevleri belirlemektir. Daha sonra Etiket referansı için görevin bilgilerini ve performansını nasıl geliştireceğinizi kontrol edebilirsiniz.

Kare Süresi Grafiği

Her çubuğun yüksekliği, karenin tamamlanması için geçen milisaniye sayısını göstermektedir. Daha yeni kareler sağ tarafta yer alır. Bir kareye üzerine gelindiğinde, CPU ve GPU kullanımına dair temel bilgiler görüntülenir.

• Turuncu çubuklar, Görev Duvar Zamanı değerinin Render Duvar Zamanı değerini aştığı karelerde bulunmaktadır. Bu karelerde, en az bir işçi iş parçacığı (betikler çalıştırmak, fizik hesaplamak ve animasyon oynamak gibi görevleri yapan) ana render iş parçacığından (bkz. iş parçacıkları) daha uzun sürdü.

  Eğer oyun, kare süresi hedeflerinize ulaşmıyorsa ve büyük sayıda turuncu kare varsa, yaygın nedenler betikler, fizik ve animasyonlardır. Performansı Geliştirme bölümünde görebilirsiniz.

• Mavi çubuklar, Render Duvar Zamanı değerinin Görev Duvar Zamanı değerini aştığı karelerde bulunmaktadır. Bu karelerde, ana render iş parçacığı, herhangi bir işçi iş parçacığından daha fazla zaman almıştır.

  Eğer oyun, kare süresi hedeflerinize ulaşmıyorsa ve büyük sayıda mavi kare varsa, bu bir render darboğazını gösterir. Yaygın nedenler aşırı nesne yoğunluğu, nesne hareketi ve aydınlatmadır. Daha fazlası için Geliştirme bölümüne bakabilirsiniz.

• Kırmızı çubuklar, her iki koşulun da doğru olduğu kareleri gösterir:

  • Render Duvar Zamanı değeri Görev Duvar Zamanı değerini aşıyor
  • GPU Bekleme Zamanı 2.5 milisaniyeden daha fazla

  Kırmızı çubuklar, turuncu ve mavi çubuklardan daha az yaygındır ve genellikle aşırı nesne karmaşıklığı, doku boyutu ve görsel efektlerin bir sonucu olarak ortaya çıkar. Optimizasyon işlemi, mavi çubuklarla benzerdir. Geliştirme bölümüne bakarak daha fazla bilgi edinebilirsiniz.

Bir çerçevede sonrasında yapılan küçük görevler bazen Görev Duvar Zamanı ve Render Duvar Zamanı değerlerini etkileyebilir, bu yüzden kare süresine odaklanmak için daha fazla sebep vardır. "İyi" bir renk aramakta değilsinizdir. Hem turuncu, hem mavi hem de kırmızı karışımını görmek, kare süresi hedeflerinizi ulaşıyorsanız sorunlu değildir. Eğer ulaşamıyorsanız, renkler nerede optimizasyon yapmanız gerektiğini gösterebilir.

Zaman Çizelgesi

• Zaman çizelgesini kaydırmak için sola tıklayıp sürükleyin. Çok sayıda CPU çekirdeğine sahip bir makinede, belirli bir görevi yerine getiren iş parçacığı'nı bulmak için yukarı veya aşağı kaydırmanız gerekebilir.

  

• Kaydırma, zaman çizelgesinin içeriğini yakınlaştırır. Zaman çizelgesinin üst kısmındaki milisaniye etiketleriyle birleştirildiğinde, bir görevin ne kadar sürdüğünü kesin bir anlamda alabiliyor, ayrıca diğer görevlere göre ne kadar sürdüğünü de anlayabiliyor olursunuz.

  

• Çubuk grafiğindeki yeşil örtü, zaman çizelgesinde şu anda görünür olan çerçeve sayısını—yakınlaştırma seviyenizi gösterir. Bir çerçeve çubuğuna sol tıklamak, zaman çizelgesindeki o konuma atlamanızı sağlar.

  Yakınlaştırma seviyenizi ayarlamanız gerekebilir, ancak bir çubuğun üzerine gelindiğinde kare zaman çizelgesinde öne çıkar. Açık gri çizgiler çerçeveleri ayırır.

  

• Bir etiketin doğrudan altında görünen etiketler, daha yüksek seviyeli görevin bir parçası olarak gerçekleştirilen görevleri gösterir.

  Ebeveyn görev yerine, genelde en kötü performans gösteren alt görevleri sorun gidermek istersiniz; bir ebeveyn görev, alt görevlerinin toplamından daha kısa olamaz.

• Bir etikete sağ tıklayıp, zaman çizelgesini tam olarak o görevin süresine yakınlaştırabilirsiniz.

• Bilgi miktarı aşırı geliyorsa, zaman çizelgesini filtrelemek için Gruplar veya İş parçacıkları menüsünü kullanabilirsiniz. Örneğin, yalnızca ana iş parçacığındaki Render görevlerini görmek isteyebilirsiniz.

  

• En çok zaman alan bir görevin meydana geldiği yeri atlamak için CtrlF (⌘F) tuşlarına basabilirsiniz. Örneğin, computeLightingPerform her istemci çerçevesinde çalışır. Eğer 128 karelik bir dökümde bunu ararsanız, en uzun sürede tamamlanan kareye atlayabilirsiniz.

İş parçacıkları

Birçok programda olduğu gibi, Roblox, görev dizilerini aynı anda yürütmek için çoklu iş parçacıkları kullanır. MikroProfil, zaman çizelgesinin sol tarafında iş parçacığı adını gösterir.

Üç önemli iş parçacığı türü vardır:

• Ana ("RBX Ana"): CPU tabanlı render görevlerini yönetir. Giriş işleme, Humanoids, animasyonlar/tweening, fizik mülkiyeti, ses ve bekleyen betik devamlarını işleme gibi görevleri gerçekleştirir. Ayrıca Studio arayüzlerini günceller ve diğer iş parçacıklarını koordine eder.

• İşçi ("RBX İşçi"): Ana iş parçacığının ağ, fizik ve yol bulma konularında destek almasına yardımcı olur. Modern CPU'larda birçok çekirdek bulunduğundan, çoğu zaman bir uyku durumunda olan birçok işçi iş parçacığına sahip olmanız muhtemeldir.

• Render ("GPU"): Bir "hazırla, gerçekleştir, sun" mantığı izler. Cihazın grafik işleme birimi (GPU) ile iletişim kurar.

  • Hazırla: Ana iş parçacığından bilgi, render modeli güncellemeleri için kullanılır.
  • Gerçekleştir: Render komutları verilir, aynı zamanda 2B arayüzler.
  • Sun: GPU ile senkronize olur.

Özel betik profilleri

Betikleriniz karmaşık görevler yürütüyorsa, kodun kritik bölümlerini analiz ederek çok uzun sürmemelerini sağlayabilirsiniz. debug.profilebegin() ve debug.profileend() ile kodu sarmalayarak, bu işlev çağrıları arasındaki her şeyin zamanını ölçebilir ve MikroProfil zaman çizelgesinde bir etiket oluşturabilirsiniz.

local RunService = game:GetService("RunService")

local function onPreSimulation()
  debug.profilebegin("Hard Work")
  -- Zor iş örneği: iki değişkeni 200.000 kez takas et
  local a, b = 0, 1
  for _ = 1, 200000 do
    a, b = b, a
  end
  debug.profileend()
end
RunService.PreSimulation:Connect(onPreSimulation)

Zaman çizelgesindeki süresinden, bu fonksiyonun diğer görevlere kıyasla çok fazla işlem süresi kullandığını anlayabilirsiniz.

Yakalamaları Assistant ile Analiz Etme

Stüdyo’da, duraklatılmış bir MikroProfil yakalamasını otomatik olarak analiz etmesi, performans darboğazlarını belirlemesi ve düzeltme önerilerinde bulunması için Assistant görevine geçebilirsiniz.

1. Stüdyo’da MikroProfil’i CtrlF6 (⌘F6) ile açın.
2. Bir kare süresi zirvesi gördüğünüzde, üst menüdeki Durdur seçeneğine tıklayarak veya CtrlP (⌘P) tuşlarına basarak yakalamayı duraklatın.
3. Assistant'ı açın ve yakalamayı analiz etmesini isteyin. Örnek istemler şunları içerebilir:

   • "MikroProfil'de bir kare süresi zirvesi yakaladım—analiz et."
   • "Zirveye ne sebep oldu?"
   • "Bu fizik bağımlı mı yoksa betik bağımlı mı?"
   • "En yüksek özel süreye sahip kategori hangisi?"
   • "Hangar içindeyken FPS düşüyor. Sorunu çoğalt, MikroProfil kullanarak nedeni bul, düzelt ve yeniden test et."

Assistant, duraklatılmış yakalamayı MikroProfil API’si aracılığıyla okur ve muhtemel darboğazlar hakkında raporlar döner, beraberinde uygulanabilecek betik veya sahne değişiklikleri önerileriyle birlikte gelir.

Bu işlevsellik, aynı zamanda Studio MCP sunucusu aracılığıyla da çalıştığı için, MikroProfil analizlerini kendi AI ajanınza veya ajansal döngünüze entegre ederek yeni değişikliklerin oyununuzun performansı üzerindeki etkisini otomatik geri bildirim alabilirsiniz.

Kare Verilerini Kaydetme

Eğer sonradan incelemek (veya bir başkasıyla paylaşmak) için bir dizi kare verisi kaydetmek isterseniz, Dosyaya Kaydet düğmesini kullanın. MikroProfil, kare verilerini microprofile-<tarih>-<saat>.html adlı bağımsız bir HTML dosyasına kaydeder.

Masaüstü istemcisinde veya Stüdyoda, Dökme menüsünü kullanın. Her iki durumda da, MikroProfil dosyayı Roblox log dizinine otomatik olarak kaydeder:

• Windows’ta %LOCALAPPDATA%\Roblox\logs dizinini kontrol edin.

  Eğer Evrensel Windows Platformu (UWP) uygulamasını kullanıyorsanız, \Users\<kullanıcı_adı>\AppData\Local\Packages\ROBLOXCORPORATION.ROBLOX_<hash>\LocalState\logs\ dizinini kontrol edin.

• macOS’ta ~/Library/Logs/Roblox dizinini kontrol edin.

Sunucuyu Profil Çıkarma

İstemciyi profil çıkarmanın yanı sıra, sunucu etkinliğine dair kısa dökümler de yakalayabilirsiniz:

1. Masaüstü istemcisinde, düzenleme izinlerinizin olduğu bir oyuna katılın.

2. Geliştirici Konsolunu CtrlF9 (⌘F9) kullanarak açın.

3. Açar menüden MikroProfil’i seçin.

4. Sunucu sekmesinde yakalayacağınız kare sayısını (maksimum 60) ve yakalamaya başlamadan önceki süreyi (maksimum 4) belirtin.

5. Sunucu kaydını başlat seçeneğine tıklayın.

   

   Birkaç saniye sonra, Geliştirici Konsolu dosyanın yolunu verir; bu yol, standart döküm ile aynıdır.

Sadece Web'e Özel Özellikler

MikroProfil'in iki kullanıcı arayüzü vardır: web arayüzü (mobil ve dökümler) ve masaüstü arayüzü (istemci ve Stüdyo). Mümkün olduğunca web arayüzünü kullanmanızı öneririz. Genel olarak, ikisi de benzer çalışır, ancak web arayüzünde birkaç ekstra özellik vardır:

• Bellek tahsisi için renk kodlamasını etkinleştirmek veya devre dışı bırakmak üzere X-Ray menüsünü kullanın.

  

  • Ana çubuk grafikte daha açık çerçeveler yüksek bellek tahsisi olduğunu gösterir.
  • Önizleme çubuğundaki daha açık kısımlar ve zaman çizelgesinde daha açık etiketler, daha yüksek bellek tahsisine sahip kare parçalarını gösterir.
  • X-ray modunda, bellek tahsislerinin toplam boyutunu göstermek için C tuşuna basın.

• Dışa Aktar menüsünü kullanarak, bir CPU veya bellek alev grafiği dışa aktarın; bu, döküme dahil olan tüm çağrı yığınlarını birleştiren, ebeveyn-alt hiyerarşisini koruyan ve süreye göre boyutlandıran özel bir görselleştirmedir. Alev grafikleri, kare süresi hedefinizi kaçırmanıza neden olmayan görevleri tanımlamak için özel olarak yararlıdır (bu yüzden fark edilmesi zor olmakta), ama o kadar sık çalışırlar ki işlem süreleri dikkate değer hale gelebiliyor.

  

  Stüdyo’da, yalnızca betikler (çalıştırma süresi ve bellek tahsisleri) için alev grafikleri oluşturmanız mümkündür. Web tabanlı alev grafiklerine göre, Stüdyo’dakiler üstten aşağıya, altıdan yukarıya değil ve oldukça daha uzun yakalama sürelerini destekler.

  

• Web arayüzüne ikinci bir döküm dosyasını sürükleyip bırakın ve bir fark alev grafiği oluşturun; bu, oyununuzun performansındaki iyileşmeleri veya gerilemeleri tanımlamaya yardımcı olabilir. Yeni bir HTML dosyası dışa aktarmak için Birleştir & Karşılaştır seçeneğine tıklayın.

  

  Birden fazla döküm dosyasını birleştirebilirsiniz—örneğin, her iki tarafta dördü, büyük bir güncellemeden önce ve sonra—daha toplu bir karşılaştırma elde etmek için. Farklı yerler arasındaki verileri karşılaştırmak da faydalı olabilir, ancak farklı yerlerin verilerini birleştirmeyin!

  Fark alev grafiği, daha fazla CPU veya bellek kullanan dökümü (sol veya sağ) vurgular ve daha parlak renkler büyük bir fark gösterir.

  

Masaüstüne Özel Özellikler

Masaüstü zaman çizelgesinde, bir etikete sol tıklayarak onu sağ alt köşedeki bir çizgi grafiğine ekleyebilirsiniz. Grafik, her çerçevede görevin ne kadar sürdüğünü gösterir. Bu grafiği kullanarak, oyununuzdaki yalnızca belirli görevlerin performansını test edebilirsiniz. İşiniz bittiğinde, grafiği gizlemek için sağ tıklayın.

Bu grafik, ana profil çubukları ile senkronize edilmiştir. Şu anda seçili olan çerçeve aralığı grafikte yeşil ile vurgulanmıştır. Bu grafikte istediğiniz yeri tıklayarak ana profil görünümünü o belli çerçeveye yeniden merkezlemek de mümkün; bu, ayrıntılı görünümde zirveleri bulmak için faydalı olur.