GameActivity Android Game Development Kit'in bir parçasıdır.
GameActivity, Android oyunlarının uygulamanın C/C++ kodundaki uygulama döngüsü komutlarını, giriş etkinliklerini ve metin girişini işlemesine yardımcı olmak için tasarlanmış bir Jetpack kitaplığıdır. GameActivity, NativeActivity'nin doğrudan bir alt öğesidir ve benzer bir mimariyi paylaşır:

Önceki şemada gösterildiği gibi GameActivity aşağıdaki işlevleri yerine getirir:
- Java tarafındaki bileşen aracılığıyla Android çerçevesiyle etkileşim kurma
- Uygulama döngüsü komutlarını, giriş etkinliklerini ve giriş metnini yerel tarafa iletme
- C/C++ kaynak kodunu üç mantıksal bileşene ayırma:
- GameActivity'nin Java işlevini doğrudan destekleyen ve etkinlikleri
native_app_glueiçin sıraya alan GameActivity'nin JNI işlevleri. native_app_glue, çoğunlukla kendi yerel iş parçacığında (uygulamanın ana iş parçacığından farklı) çalışır ve görevleri kendi döngüleyicisiyle yürütür.- Uygulamanın oyun kodu,
native_app_glueiçinde sıraya alınan etkinlikleri sorgulayıp işler ve oyun kodununative_app_glueiş parçacığında yürütür.
- GameActivity'nin Java işlevini doğrudan destekleyen ve etkinlikleri
GameActivity sayesinde, JNI koduyla uğraşmak için çok fazla zaman harcamak yerine oyun geliştirme sürecine odaklanabilirsiniz.
NativeActivity hakkında bilgi sahibiyseniz GameActivity ile NativeActivity arasındaki temel farklar şunlardır:
GameActivity,SurfaceViewolarak oluşturulur. Bu sayede oyunların diğer kullanıcı arayüzü bileşenleriyle etkileşime girmesi çok daha kolay olur.- Dokunma ve tuş girişi etkinlikleri için
GameActivity,NativeActivitytarafından kullanılanInputQueue'ten ayrı,android_input_bufferarayüzüyle tamamen yeni bir uygulamaya sahiptir. GameActivity,AppCompatActivity'in türetilmiş bir sınıfıdır ve diğer Jetpack bileşenlerini sorunsuz bir şekilde kullanmanıza olanak tanır.ActionBar,Fragmentve diğerleri kullanılabilir.GameActivity, GameTextInput kitaplığını entegre ederek metin girişi işlevi ekler.GameActivity'dan türetilen uygulamaların, C/C++ kodunun üç bölümünü de tek bir kitaplıkta derlemesi beklenir. Öte yandan,NativeActivityuygulamasının JNI işlevleri, çerçevenin bir parçasıdır (her zaman OS tarafından yüklenir). Bu nedenle, yalnızcanative_app_glueve uygulamanın C/C++ kodunun tek bir kitaplıkta derlenmesi beklenir.NativeActivity, Android çerçevesinin bir parçasıdır ve sürüm döngüsünü (genellikle yıllık) takip eder.GameActivity, Jetpack kitaplığının bir parçasıdır. Bu kitaplığın yayın döngüsü çok daha sık olduğundan (genellikle iki haftada bir) yeni özellikler ve hata düzeltmeleri çok daha hızlı bir şekilde sunulabilir.
Konumları serbest bırakma
GameActivity kitaplığı aşağıdaki kanallarda kullanılabilir:
- Android Jetpack kitaplığının bir parçası olarak (önerilir)
- AOSP kaynak kodu olarak
C/C++ kodu, Prefab biçimi kullanılarak tüm sürüm kanallarında kaynak kodu olarak sağlanır. GameActivity 1.2.2 sürümü, dağıtıma statik bir kitaplık ekler. Bu sürümden itibaren kaynak kodu yerine statik kitaplığı kullanmanızı öneririz.
Jetpack kitaplığının içeriği
Jetpack kitaplığıyla GameActivity, AAR ile yayınlanır. Bu AAR aşağıdaki ana bileşenleri içerir:
- Java kodu için JAR dosyası
- C/C++ statik kitaplığı
game-activity_static, GameActivity 1.2.2 ve sonraki sürümlere dahildir. - C/C++ kaynak kodu (
/prefabklasörünün altında)
Bu sayfada bağlantısı verilen entegrasyon talimatları, derleme sisteminizde Prefab'i kullanabileceğinizi varsayar. Aksi takdirde, prefab/modules/game-activity/include klasöründe paketlenmiş kaynak kodunu derleme sisteminize kopyalayabilir ve gerekli entegrasyon adımlarını uygulayabilirsiniz. Android Jetpack kitaplığı için androidx altındaki sürümlerde benzer bir dosya yapısı vardır. Gradle, varsayılan olarak AAR'leri önbellek dizinine (~/.gradle/caches/...) açar. C/C++ kaynak kodunu bulmak için prefab/modules/game-activity/include araması yapıp istediğiniz yayınlanan sürümün altındaki konumu seçebilirsiniz.
Jetpack kitaplığını kullanarak entegrasyon yapma talimatları için GameActivity'yi kullanmaya başlama başlıklı makaleyi inceleyin.
AOSP kaynak kodunun içeriği
AOSP her zaman en güncel kaynak kodunu içerir. Kendi sürümlerinizi oluşturmak için derleme talimatlarını uygulayın veya kaynağı doğrudan derleme ortamınıza entegre edin. C/C++ kaynak kodu, Jetpack kitaplığına benzer bir dosya yapısına kaydedilir.
Entegrasyon kılavuzları
GameActivity ürününü uygulamalarınıza entegre etmek için bu kılavuzları takip edin:
Ek kaynaklar
GameActivity hakkında daha fazla bilgi edinmek için aşağıdakilere göz atın:
- GameActivity ve AGDK sürüm notları.
- GameActivity'de GameTextInput'i kullanma
- NativeActivity geçiş rehberi
- GameActivity referans belgeleri.
- GameActivity uygulaması.
Geri bildirim
GameActivity'de hata bildirmek veya yeni özellikler istemek için GameActivity Issue Tracker'ı kullanın.