Aracılığıyla paylaş

Hızlı Başlangıç: Gerçek Olmayan Altyapı için Visual Studio Araçları

  • Makale

Bu makalede, bir Unreal Engine (UE) oyun örneğini indirin ve Unreal Engine için Visual Studio Araçları kullanarak şunları yapın:

Önkoşullar

Aşağıdakiler yüklenmelidir:

  • Visual Studio sürüm 17.7 veya üzeri
  • Bu hızlı başlangıçta kullanılan örnek UE5 veya sonraki bir sürümü gerektirdiğinden, Gerçek Dışı Altyapı sürüm 5 veya üzeri.
  • Unreal Engine için Visual Studio Araçları. Yükleme yönergeleri için bkz. Unreal Engine için Visual Studio Araçları yükleme.

Visual Studio'da Lyra oyun örneğini indirme ve derleme

Lyra, Unreal Engine'deki çerçeveleri öğrenmeye yönelik örnek bir 3B oyun projesidir. İndirme yönergeleri için Lyra Örnek Oyunu'ndaki Lyra Başlangıç Oyununu İndirme bölümüne bakın.

Lyra oyun örneğini Unreal Engine için Visual Studio Araçları kullanacak şekilde yapılandırma

Oyun örneğini indirdikten sonra Visual Studio Araçları eklentisini kullanacak şekilde güncelleştirinLyraStarterGame.uproject. Bunu, Eklentileri Düzenle>altındaki ana menüden Gerçek Dışı Düzenleyici'de de yapabilir ve ardından Visual Studio Tümleştirme eklentisini bulup yanındaki kutuyu işaretleyebilirsiniz. Ancak bunu şu adımları izleyerek yapacağız:

  1. LyraStarterGame.uproject Dosyayı bir metin düzenleyicisinde açın. Oyun örneğini yüklediğiniz dizinde bulunur.

  2. Bölümün sonuna Plugins aşağıdakileri ekleyin:

     ,{
 	"Name": "VisualStudioTools",
 	"Enabled": true
 }

  3. Lyra projesini Unreal Engine'de açın.

  4. Gerçek Dışı Altyapı düzenleyicisi ana menüsünde Araçlar>Visual Studio Projesini Yenile'yi seçin. Bu, Visual Studio için çözüm dosyasını oluşturur/yeniler.

  5. Gerçek Dışı Altyapı düzenleyicisi ana menüsünde Araçlar>Visual Studio'yu Aç'ı seçin. Bu işlem, oyunu Visual Studio'da açar. Makinenizde birden çok Visual Studio sürümü varsa, doğru sürümün açıldığından emin olun: Visual Studio ana menüsünden Microsoft Visual Studio Hakkında Yardım'ı>seçin. Visual Studio 2022 sürüm 17.7 veya üzerini kullanmanız gerekir. Doğru sürüm açılmadıysa Visual Studio'nun doğru sürümünde el ile açın LyraStarterGame.sln .

  6. Visual Studio ana menüsünden Derleme Çözümü Oluştur'u>seçerek oyunu oluşturun.

  7. Çözüm Yapılandırmaları açılan listesini Geliştirme Düzenleyicisi olarak değiştirin. Bu, Gerçek Dışı Altyapı için Blueprints Visual Studio Araçları etkinleştirir:Screenshot of Visual Studio with the Solutions Configurations dropdown expanded and Development Editor selected.

Visual Studio'da UE Şemalarını Görüntüleme

UE Şemalarını Visual Studio'dan görüntüleyebilir ancak düzenleyemezsiniz. Unreal Editor ile Visual Studio arasında geçiş yapmak zorunda kalmadan UE Blueprints'i görebildiğiniz için bu kullanışlıdır. Denemek için şu adımları izleyin:

  1. Visual Studio'da dosyasını açın LyraCharacter.h. bu dosyayı Çözüm Gezgini Arama bölmesinde arayın veya Games>LyraStarterGame>Source>LyraGame>Character>LyraCharacter.h altında bulun
  2. içinde LyraCharacter.h96. satıra gidin. Aşağıdaki sınıfı görmeniz gerekir: class LYRAGAME_API ALyraCharacter : public AModularCharacter ...
  3. Bu sınıfı genişleten dört Blueprint sınıfı vardır. Sınıf tanımının ALyraCharacter hemen üstünde şunu belirten bir bağlantı görmeniz gerekir: 4 derived Blueprint classes. Bu sınıfı genişleten dört Blueprint sınıfını görüntülemek için bu bağlantıya tıklayın: Screenshot of the blueprints link above the Alyra Character class. It lists related blueprints.
  4. Şemanın özelliklerini görüntülemek için şemaya Character_Default_C çift tıklayarak Şema varlık görüntüleyicisini açın. Şemanın çeşitli özelliklerini görüntüleyebilirsiniz, ancak değiştiremezsiniz: Screenshot of the Character_Default_C Blueprint asset viewer. It shows properties such as Actor, Camera, Character, Collision, and so on.

Visual Studio'da UE günlüğünü görüntüleme

Visual Studio'da UE günlüğünü görüntülemek için Gerçek Dışı Altyapı Visual Studio Araçları kullanabilirsiniz. Unreal Editor ile Visual Studio arasında geçiş yapmak zorunda kalmadan UE günlüğünü görebildiğiniz için bu yararlı olur. Denemek için şu adımları izleyin:

  1. Visual Studio'da dosyasını açın LyraGameplayAbility_RangedWeapon.cpp. bu dosyayı Çözüm Gezgini Arama bölmesinde arayın veya Games>LyraStarterGame>Source>LyraGame>Weapons>LyraGameplayAbility_RangedWeapon.cpp altında bulun

  2. içinde LyraGameplayAbility_RangedWeapon.cpp477. satıra gidin. Şu işlevi görmeniz gerekir: void ULyraGameplayAbility_RangedWeapon::OnTargetDataReadyCallback

  3. İşlevin başına aşağıdaki kodu ekleyin: UE_LOG(LogLyra, Log, TEXT("shot fired")); Bu, bu işlev çağrıldığında günlüğe kaydeden kategorisiyle LogLyrailişkilendirilmiş bir günlük shot fired girdisi oluşturur.

  4. Hata AyıklamaYı Başlat Hata Ayıklama'ya> tıklayarak örnek oyunu Visual Studio'da çalıştırın. Unreal Editor, Lyra oyunuyla açılacaktır. Yüklenmesi için birkaç dakika bekleyin.

  5. Visual Studio'da, Visual Studio ana menüsünden Diğer Windows>Gerçek Dışı Altyapı Günlüğünü Görüntüle'yi>seçerek UE günlük penceresini açın.

  6. Gerçek Dışı Düzenleyici'de, oyunu başlatmak için araç çubuğundaki (veya Alt+p) Yürüt düğmesini seçin.

  7. Lyra oyununda oyuncuyu Eleme portalına gitmek için , a, s, d tuşlarını kullanınw. Oyunu yüklemek için oyuncuyu giriş portalının üzerine getirin.

  8. Oyun çalıştırıldıktan sonra, ateş etmek için fare düğmesine tıklayın. Bu, kategoride LogLyra bazı günlük girdileri oluşturur. Şimdi LogLyra , sonraki adım için Kategoriler filtresinde görünür.

  9. UE günlük penceresindeki LogLyra kategori olayları dışında tüm olayları şu şekilde filtreleyerek günlük gürültüsünü azaltın: Kategoriler açılan listesini seçin. Tüm günlük kaynaklarını temizlemek için listenin üst kısmındaki (Tümünü Seç) öğesini seçin. Ardından LogLyra'yı seçin. UE günlük penceresinde günlük iletisini görmeniz gerekir: : shot fired

    A screenshot of the Unreal Engine Log window showing 'shot fired' events and the Categories dropdown with LogLyra selected.

    Olaylar günlüğün en altındadır, bu nedenle bunları görmek için aşağı kaydırmanız gerekebilir. Ayrıca, günlüğü temizlemek için Temizle düğmesini seçebilir ve ardından günlük iletisini görmek için yeniden tetikleyebilirsiniz.

Yazı tipi renginin okunmasının zor olduğunu fark ederseniz, Araç>Seçenekleri>Ortam>Yazı Tipleri ve Renkler'in altında bunu ayarlayabilirsiniz. Şunun için ayarları göster açılan listesini Gerçek Dışı Altyapı Günlüğü olarak değiştirin. Öğeleri görüntüle: Günlük'etıklayın ve Öğe ön plan rengini sizin için daha kolay görünen bir renkle değiştirin.

Hata ayıklarken UE günlük penceresinin açık olması kullanışlıdır çünkü bunları görmek için Gerçek Olmayan Düzenleyici'ye geçmeniz gerekmez.

Visual Studio'da UE makrolarını görüntüleme

Uzun UE makrolarını okumak zor olabilir. Unreal Engine için Visual Studio Araçları, UE makrolarını daha kolay okuyabilmeniz için genişletir. İsterseniz genişletilmiş makroyu kopyalayabilirsiniz. Ayrıca çevrimiçi olarak arayabilir veya başka bir makroyla karşılaştırabilirsiniz. Bu özelliklerle deneme yapmak için şu adımları izleyin:

  1. Visual Studio'da dosyasını açın LyraGameplayAbility_RangedWeapon.cpp. bu dosyayı Çözüm Gezgini Arama bölmesinde arayın veya Games>LyraStarterGame>Source>LyraGame>Weapons>LyraGameplayAbility_RangedWeapon.cpp altında bulun

  2. içinde LyraGameplayAbility_RangedWeapon.cpp41. satıra gidin. Aşağıdaki makroyu görmeniz gerekir: UE_DEFINE_GAMEPLAY_TAG_STATIC(TAG_WeaponFireBlocked, "Ability.Weapon.NoFiring");

  3. Makro tanımı penceresini görmek için fare işaretçisini üzerine UE_DEFINE_GAMEPLAY_TAG_STATIC getirin: A screenshot in Visual Studio of the UE macro tooltip. There are options at the bottom to copy, expand inline, visualize expansion, and search online. Alttaki seçenekler makroyu panoya kopyalar, makroyu satır içi olarak genişletir, makronun genişlemesini görselleştirir ve çevrimiçi ortamda makroyu arar.

  4. Kod penceresinde makroyu ve iç içe yerleştirilmiş tüm makroları genişletmek için Satır İçi Genişlet'i seçin. A screenshot of the expanded contents of the UE_DEFINE_GAMEPLAY_TAG_STATIC macro. Genişletmeyi geri almak için basabilirsiniz Ctrl+z .

  5. Tarayıcınızı açmak için Çevrimiçi ara'yı seçin. Makroyu bulmak için bir arama doldurulmuş olarak açılır. Önceki örnekte bu, arama yapmak için tarayıcıyı açar C++ #define UE_DEFINE_GAMEPLAY_TAG_STATIC(TagName, Tag) static FNativeGameplayTag TagName(UE_PLUGIN_NAME, UE_MODULE_NAME, …

  6. Makro Genişletme penceresini açmak için Genişletmeyi görselleştir'i seçin. Büyük makronun parçası olan iç içe makroları her seferinde bir adım genişletebilirsiniz. Pencerenin sağ üst köşesindeki makro genişletme oklarını görmek için genişletmenin sonuna kaydırın. Sonraki iç içe makroyu genişletmek için sağ oku seçin. Genişletilen son iç içe makroyu daraltmak için sol oku seçin:

    A screenshot of the macro expansion window showing the expanded contents of the UE_DEFINE_GAMEPLAY_TAG_STATIC macro.

Visual Studio'da makroları genişletme hakkında daha fazla bilgi için bkz . C/C++ makro genişletmesini görselleştirme.

Bu hızlı başlangıçta, Unreal Engine için Visual Studio Araçları'nin UE makrolarını anlamayı, UE günlüğünü görüntülemeyi ve UE Blueprints'i görüntülemeyi nasıl daha kolay hale getirdiği gösterildi. UE geliştirme çalışmalarınız daha üretken ve keyifli olsun!

Sonraki adımlar

Unreal Engine özelliklerine yönelik Visual Studio Araçları genel bakış için Bkz. Unreal Engine için Visual Studio Araçları.