Huawei Kitleri Cocos Creator’da nasıl kullanılır ?
Selamlar,
Bu makalede Huawei Kitlerinin Cocos Creator’da nasıl kullanabileceğini inceleyeceğiz.
Giriş
2019'dan beri Cocos, Huawei ile mobil oyun geliştirmeye üzerine işbirliği içerisinde.
Geliştiriciler, Cocos Creator kullanarak tek tık ile Huawei HMS Core’u projelerine entegre edebiliyor ve oyunlarını sorunsuz bir şekilde HUAWEI AppGallery Connect’e yükleyebiliyorlar.
Cocos Creator Nedir ?
Cocos Creator gelişmiş, bileşen tabanlı ve veri odaklı bir oyun geliştirme aracıdır. Cocos Creator yüksek performansı, geliştiriciye kolaylık sağlayacak çeşitli özellikleri ve kolay kullanımı cross platform desteği ile bir araya getirmektedir. Bu yeni oyun motoru geliştiricilere 2D ve 3D oyun geliştirme sürecinde yeni bir tercih olmak için tasarlanmıştır.
Cocos Hangi Huawei Kitlerini destekliyor ?
Cocos aşağıda yer alan tüm HMS kitlerini desteklemektedir.
Cocos SDKHub → Account Kit, In-App Purchases, Ads Kit, Push Kit, Game Service(game service her cocos creator versiyonunda bulunmayabiliyor)
HUAWEI HMS Core → Analytics Kit
HUAWEI AppGalleryConnect → APM, Auth Service, Crash Kit, App Messaging, Remote Config, Cloud Store, Cloud DB, Cloud Functions
Cocos Creator’da Huawei Kitleri nasıl kullanılır ?
Bir proje oluşturarak Huawei servislerinin Cocos Creator’da nasıl entegre edildiğini görelim.
“Hello World” örnek bir Cocos Creator projesi. Ben görsellik açısından bu başlangıç projesini tercih edeceğim. Tabi dilerseniz boş bir sahne oluşturup da aynı işlemleri de yapabilirsiniz.
Cocos Creator’un Service panelinde Huawei Kitlerinin hızlı bir şekilde entegrasyonunu yapmamıza yarayan bir bölümü bulunmakta.
Menu barı -> Panel -> Service seçeneklerini seçelim ve Servis panelini açalım.
İlk olarak projemizi bir uygulamaya bağlamamız gerekiyor.
Service → Set Cocos AppID seçeneğine tıklayalım.
Karşımıza gelen açılır pencere de oyunumuzu seçmemiz gerekiyor.
Eğer Cocos Servis panelinden bir oyun oluşturmadıysanız sağ alttaki Click Create butonuna tıklayarak bu işlemi tamamlayabilirsiniz.
Bu işlemi daha önce yapmadığımızı varsayalım yapmamız gereken adımlar aşağıdaki gibi:
Click Create butonuna tıkladıktan sonra Create Game sayfasına aktarılacağız.
Gerekli bilgileri doldurun Create butonuna basalım.
Artık uygulamanızı açılır pencerede görüntüleyebilirsiniz.
Not: Eğer projeyi yeni oluşturduysanız, projeyi görmek için açılır pencereyi tekrar açmanız gerekebilir.
Artık istediğimiz servisi aktif hale getirebiliriz.
Ben örnek olarak Ads Kit’i aktif hale getireceğim.
Ads Kit Cocos SDKHub servisinin altında olduğu için öncelikle CocosSDKHub’ı aktif etmemiz gerekiyor.
CocosSDKHub’a tıklayın.
Şimdi CocosSDKHub servis panelinde aşağıdaki gibi CocosSDKHub’ı etkinleştirin.
CocosSDKHub servisini başarılı bir şekilde aktifleştirdik.
Params bölümü altında kırmızı bir şekilde Not Configured yazdığını görebilirsiniz.
Bunun sebebi Cocos SDKHub’ın 4 tane Huawei Servisi içermesi ve ilk aktif edildiğinde bunların 4'ünü de otomatik olarak etkinleştirmesi. Bunu düzeltmek için Plugin Manage butonuna tıklayalım.
Not: Eğer ek konfigürasyon içeren bir servis kullanıyorsanız parametreleri “Edit” butonuna tıklayarak girebilirsiniz. Daha fazla bilgi için buraya tıklayabilirsiniz.
Kullanmak istemediğimiz kitlerin seçimini kaldırarak OK butonuna tıklayalım.
Artık Params bölümünün altında bir hata görmüyoruz.
Şimdi sıra Ads Kit’i kullanabilmek için gereken scriptlerimizi yazmakta.
İlk olarak yazacağımız script’i üzerine ekleyebileceğimiz boş bir Node ekleyelim. Ben bu Node’a “HuaweiAdsManager” ismini verdim.
Daha sonra Sağ Asset klasörüne sağ tıklayarak ve Assets → Create → TypeScript → NewComponent ‘e tıklayarak yeni bir script oluşturdum.
Yeni scriptime “HuaweiAdsManager” ismini verdim.
Şimdi Scriptimizi açalım.
HuaweiAdsManager.ts sınıfımız aşağıdaki gibi olacak.
Artık projemizi build edebiliriz.
Project → Build ‘e tıklayalım
Platform olarak “HUAWEI AppGallery Connect” seçtiğinizden emin olun.
AGC’deki paket adınızı ve Projenin Target API Level’ini girmeyi unutmayın.
Şimdi projemizin keystore ve agconnect-services.json dosyasını girmemiz gerekiyor.
Here you can find how to integrate your app with HMS and get the ag-connect file.
Aşağıdaki makalelerden HMS entegrasyonu sırasında keystore’un nasıl elde edileceği ve ag-connect json dosyasını nasıl alabileceğinizi öğrenebilirsiniz.
Bu adımlardan sonra projemizi build edip çalıştırabiliriz.
Son olarak diğer Ads türlerinin de yer aldığı scriptimiz aşağıdaki gibidir.
Proje dosyalarına aşağıdan ulaşabilirsiniz.
Sonuç
Cocos, mobil cihazlar ve diğer platformlar için 2D oyunlar yapmak için bir temel olarak uzun süredir var. Ve 2018'in sonundan itibaren, Cocos’un dünya çapında 1,1 milyar oyun cihazını kapsayan 1,3 milyondan fazla aktif oyun geliştiricisi var. Cocos ve Huawei arasındaki derinlemesine işbirliği, küresel oyunlara, özellikle Çin oyunlarına yeni fırsatlar getirmeyi amaçlıyor.
Bu nedenle, HMS Kitlerini oyununuza entegre etmeye başlamanın tam zamanı.