AndroidでGamebaseを利用するためのシステム環境は、次の通りです。
[最小仕様]
- 使用者実行環境:Android API21 (Lollipop, OS 5.0)以上
- ビルド環境:Android Gradle Plugin 4.0.1以上
- 開発環境:Android Studio
Gamebase SDK | Gamebase Adapter | External SDK | 用途 | minSdkVersion |
---|---|---|---|---|
Gamebase | gamebase-sdk | nhncloud-core-1.9.3 nhncloud-common nhncloud-crash-reporter-ndk nhncloud-logger gson-2.8.9 okhttp-3.12.13 kotlin-stdlib-1.8.0 kotlin-stdlib-common kotlin-stdlib-jdk7 kotlin-stdlib-jdk8 kotlin-android-extensions-runtime kotlinx-coroutines-core-1.6.4 kotlinx-coroutines-android kotlinx-coroutines-core-jvm |
Gamebaseのインターフェイスおよびコアロジックを含む | API 21(Lollipop, OS 5.0) |
Gamebase Auth Adapters | gamebase-adapter-auth-appleid | - | Sign In With Appleログインをサポート | - |
gamebase-adapter-auth-facebook | facebook-login-16.1.2 | Facebookログインをサポート | - | |
gamebase-adapter-auth-google | play-services-auth-20.3.0 | Googleログインをサポート | - | |
gamebase-adapter-auth-gpgs-v2 | play-services-games-v2-20.1.2 | GPGS(Google Play Games Services) V2ログインをサポート Player IDベース |
- | |
gamebase-adapter-auth-gpgs-autologin | play-services-games-v2-20.1.2 | GPGS(Google Play Games Services)自動ログインをサポート | - | |
gamebase-adapter-auth-hangame | hangame-id-1.17.0 | Hangameログインをサポート | - | |
gamebase-adapter-auth-line | linesdk-5.8.1 | Lineログインをサポート | - | |
gamebase-adapter-auth-naver | naveridlogin-android-sdk-5.7.0 | NAVERログインをサポート | - | |
gamebase-adapter-auth-payco | payco-login-1.5.15 | Paycoログインをサポート | - | |
gamebase-adapter-auth-twitter | - | Twitterログインをサポート | - | |
gamebase-adapter-auth-weibo | sinaweibosdk.core-13.5.0 | Weiboログインをサポート | - | |
gamebase-adapter-auth-weibo-v4 | openDefault-4.4.4 | Weiboログインをサポート | - | |
gamebase-adapter-auth-kakaogame | kakaogame.idp_kakao-3.19.3 kakaogame.gamesdk-3.19.3 kakaogame.common-3.19.3 kakao.sdk.v2-auth-2.17.0 kakao.sdk.v2-partner-auth-2.17.0 kakao.sdk.v2-common-2.17.0 play-services-ads-identifier-17.0.0 |
Kakaoログインをサポート | API 23(Marshmallow, OS 6.0) | |
gamebase-adapter-auth-steam | - | Steamログインをサポート | API 25(Nougat, OS 7.1.1) | |
Gamebase IAP Adapters | gamebase-adapter-toastiap | toast-gamebase-iap-0.21.0 nhncloud-iap-core |
ゲーム内決済をサポート | - |
gamebase-adapter-purchase-amazon | nhncloud-iap-amazon | Amazon Appstoreをサポート | - | |
gamebase-adapter-purchase-galaxy | nhncloud-iap-galaxy | Galaxy Storeをサポート | - | |
gamebase-adapter-purchase-google | billingclient.billing-5.0.0 nhncloud-iap-google |
Google Play Storeをサポート | - | |
gamebase-adapter-purchase-huawei | nhncloud-iap-huawei | Huawei App Galleryをサポート | - | |
gamebase-adapter-purchase-onestore | nhncloud-iap-onestore | ONE store v17をサポート | - | |
gamebase-adapter-purchase-onestore-v19 | nhncloud-iap-onestore-v19 | ONE store v19をサポート | - | |
gamebase-adapter-purchase-onestore-v21 | nhncloud-iap-onestore-v21 | ONE store v21をサポート | API 23(Marshmallow, OS 6.0) | |
gamebase-adapter-purchase-onestore-external | nhncloud-iap-onestore-external | ONE store外部決済機能をサポート | - | |
gamebase-adapter-purchase-mycard | nhncloud-iap-mycard | MyCard決済機能をサポート | - | |
Gamebase Push Adapters | gamebase-adapter-toastpush | nhncloud-push-analytics nhncloud-push-core nhncloud-push-notification |
Pushをサポート | - |
gamebase-adapter-push-adm | nhncloud-push-adm | Amazon Device Messagingをサポート | - | |
gamebase-adapter-push-fcm | firebase-messaging-17.6.0 nhncloud-push-fcm |
Firebase Notificationをサポート | - |
[注意]
- NHN Cloud Consoleで新しいプロジェクトを作成してGamebaseサービスが有効になっていることを必ず確認してください。
- 各IdPのコンソールでClient IDを発行してGamebaseコンソールに入力していることを必ず確認してください。
buildscript {
repositories {
...
// [Huawei App Gallery] Maven repository address for the HMS Core SDK.
maven { url 'https://developer.huawei.com/repo/' }
}
dependencies {
...
// [Huawei App Gallery] AppGallery Connect plugin configuration. please use the latest plugin version.
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}
mavenCentral()
保存場所を追加してください。// >>> [Huawei App Gallery] agconnect plugin for huawei - when Native Android build
apply plugin: 'com.huawei.agconnect'
repositories {
// >>> For Gamebase SDK
mavenCentral()
...
// >>> [Huawei App Gallery]
maven { url 'https://developer.huawei.com/repo/' }
}
// >>> [ONE store v21]
maven { url 'https://repo.onestore.co.kr/repository/onestore-sdk-public' }
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
// >>> Gamebase Version
def GAMEBASE_SDK_VERSION = 'x.x.x'
// >>> Gamebase - Add Auth Adapter
implementation "com.toast.android.gamebase:gamebase-adapter-auth-google:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-gpgs-v2:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-facebook:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-appleid:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-twitter:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-naver:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-line:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-payco:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-weibo:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-steam:$GAMEBASE_SDK_VERSION"
// >>> Gamebase - Select Purchase Adapter
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-google:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v21:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-external:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-galaxy:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-amazon:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-huawei:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-mycard:$GAMEBASE_SDK_VERSION"
// >>> Gamebase - Select Push Adapter
implementation "com.toast.android.gamebase:gamebase-adapter-push-fcm:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-push-adm:$GAMEBASE_SDK_VERSION"
// >>> 次のモジュールの使用方法はサポートへお問い合わせください。
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangame:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejp:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejpemail:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-kakaogame:$GAMEBASE_SDK_VERSION"
// >>> [Weibo v4]
// https://github.com/nhn/toast.gamebase.android.sample/tree/main/weibo_sdk
implementation files('libs/openDefault-4.4.4.aar')
implementation "com.toast.android.gamebase:gamebase-adapter-auth-weibo-v4:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v16]
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v16:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v17]
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v19]
// https://github.com/ONE-store/onestore_iap_release/tree/iap19-release/android_app_sample/app/libs
implementation files('libs/iap_sdk-v19.01.00.aar')
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v19:$GAMEBASE_SDK_VERSION"
// >>> [GPGS Auto Login]
implementation "com.toast.android.gamebase:gamebase-adapter-auth-gpgs-autologin:$GAMEBASE_SDK_VERSION"
// >>> [Push Custom Receiver]
implementation "com.toast.android.gamebase:gamebase-adapter-push-notification:$GAMEBASE_SDK_VERSION"
}
android {
compileOptions {
// >>> [AndroidX]
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
defaultConfig {
// >>> [Weibo IdP]
ndk {
abiFilters 'armeabi' // , 'armeabi-v7a', 'arm64-v8a'
}
}
}
}
Unityビルドの場合
'Firebase Console > プロジェクト設定' からgoogle-services.jsonファイルをダウンロードし、xml変換のためのgenerate_xml_from_google_services_json.exeファイルもダウンロードした後、下記のコマンドを実行してjsonファイルを xmlファイルに変換できます。
"{UnityProject}\Firebase\Editor\generate_xml_from_google_services_json.exe" -i "{JsonFilePath}\google-services.json" -o "{UnityProject}\Assets\Plugins\Android\res\values\google-services.xml" -p "{PackageName}"
変換したxmlファイルは'Androidライブラリプロジェクト'にリソースとして追加する必要があります。
Unrealビルドの場合
GoogleServicesFilePath
の値をFirebaseコンソールからダウンロードしたgoogle-services.json
のパスに指定します。GoogleServicesFilePath
の値を空白にしておけば、GamebaseはそのjsonをAndroidリソースに変換する作業を行いません。サポートページ(Game > Gamebase > Android SDK使用ガイド > ETC > Additional Features > Contact)でお問い合わせの際、写真やメディアを添付するために~API 21でストレージの読み取り権限宣言が必要です。
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="21"/>
Android API Level 22以上の端末でもREAD_EXTERNAL_STORAGE権限が必要な場合は、android:maxSdkVersion="21"構文を削除し、ランタイム権限リクエストを実装する必要があります。
AndroidManifest.xml
<manifest ...>
<application ...>
...
<!-- [Facebook] Configurations begin -->
<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id" />
<meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token"/>
<!-- [Facebook] Configurations end -->
...
</application>
</manifest>
res/values/strings.xml
<resources>
<!-- [Facebook] Facebook APP ID & Client Token -->
<string name="facebook_app_id">123456789012345</string>
<string name="facebook_client_token">a01234bc56de7fg89012hi3j45k67890</string>
</resources>
AndroidManifest.xml
<manifest ...>
<application ...>
...
<!-- [GPGS] Configurations begin -->
<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/google_play_game_services_project_id" />
<!-- [GPGS] Configurations end -->
...
</application>
</manifest>
res/values/strings.xml
<resources>
<!-- [GPGS] Google Play Games Application ID -->
<string name="google_play_game_services_project_id">1234567890</string>
</resources>
<application android:networkSecurityConfig="@xml/my_network_security_config"
...>
...
</application>
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<!-- Weibo SDK start -->
<domain includeSubdomains="true">sina.cn</domain>
<domain includeSubdomains="true">weibo.cn</domain>
<domain includeSubdomains="true">weibo.com</domain>
<domain includeSubdomains="true">sinaimg.cn</domain>
<domain includeSubdomains="true">sinajs.cn</domain>
<domain includeSubdomains="true">sina.com.cn</domain>
<!-- Weibo SDK end -->
</domain-config>
</network-security-config>
<manifest>
...
<application>
...
<!-- [ONE store] Configurations begin -->
<!-- popup:ポップアップ決済画面 / full:全体決済画面 -->
<meta-data
android:name="iap:view_option"
android:value="popup | full" />
<!-- [ONE store] Configurations end -->
...
</application>
</manifest>
決済画面 | 設定値 |
---|---|
全体決済画面 | "full" |
ポップアップ決済画面 | "popup" |
<meta-data
android:name="com.huawei.hms.client.appid"
android:value="appid=123456789">
</meta-data>
<meta-data
android:name="com.huawei.hms.client.cpid"
android:value="cpid=1234567891234">
</meta-data>
注意:ユーザー端末にHuawei App Galleryがインストールされている時のみ正常に決済が可能です。
<application
android:name="com.toast.android.gamebase.purchase.mycard.GamebaseMyCardApplication"
...>
...
</application>
class MyApplication: GamebaseMyCardApplication() {
...
}
<application>
<meta-data android:name="iap:test_mode" android:value="true | false"/>
</application>
Example
<!-- Notification priority -->
<meta-data android:name="com.toast.sdk.push.notification.default_priority"
android:value="1"/>
<!-- Notification background color -->
<meta-data android:name="com.toast.sdk.push.notification.default_background_color"
android:resource="@color/defaultNotificationColor"/>
<!-- LED light -->
<meta-data android:name="com.toast.sdk.push.notification.default_light_color"
android:value="#0000ff"/>
<meta-data android:name="com.toast.sdk.push.notification.default_light_on_ms"
android:value="0"/>
<meta-data android:name="com.toast.sdk.push.notification.default_light_off_ms"
android:value="500"/>
<!-- Small icon -->
<meta-data android:name="com.toast.sdk.push.notification.default_small_icon"
android:resource="@drawable/ic_notification"/>
<!-- Sound -->
<meta-data android:name="com.toast.sdk.push.notification.default_sound"
android:value="notification_sound"/>
<!-- Vibrate pattern -->
<meta-data android:name="com.toast.sdk.push.notification.default_vibrate_pattern"
android:resource="@array/default_vibrate_pattern"/>
<!-- Use badge icon or not -->
<meta-data android:name="com.toast.sdk.push.notification.badge_enabled"
android:value="true"/>
<!-- Enable notification when application is foreground. -->
<meta-data android:name="com.toast.sdk.push.notification.foreground_enabled"
android:value="false"/>
meta-data key | value type | description |
---|---|---|
com.toast.sdk.push.notification.default_priority | int | 優先順位。 以下の5つの値を設定できます。 NoticationComapt.PRIORITY_MIN : -2 NoticationComapt.PRIORITY_LOW : -1 NoticationComapt.PRIORITY_DEFAULT : 0 NoticationComapt.PRIORITY_HIGH : 1 NoticationComapt.PRIORITY_MAX : 2 |
com.toast.sdk.push.notification.default_background_color | int | 背景色。 |
com.toast.sdk.push.notification.default_light_color | int | LED色。 |
com.toast.sdk.push.notification.default_light_on_ms | int | LEDが点灯する時の時間。 |
com.toast.sdk.push.notification.default_light_off_ms | int | LEDが消える時の時間。 |
com.toast.sdk.push.notification.default_small_icon | resource id | 小さいアイコンのリソース識別子。 |
com.toast.sdk.push.notification.default_sound | String | 通知音ファイル名。 Android 8.0未満のOSでのみ動作します。 「res/raw」フォルダのmp3、wavファイル名を指定すると、通知音が変更されます。 |
com.toast.sdk.push.notification.default_vibrate_pattern | long[] | 振動のパターン。 |
com.toast.sdk.push.notification.badge_enabled | boolean | バッジアイコンの使用有無。 |
com.toast.sdk.push.notification.foreground_enabled | boolean | フォアグラウンド通知の使用有無。 |
[注意]
- 'queries'タグは既存Android Gradle Plugin(AGP)では認識できず、ビルドが失敗します。
- 以下のガイドおよび表を参考にして'queries'タグビルドが可能なAGPバージョンにアップグレードしてください。
- https://android-developers.googleblog.com/2020/07/preparing-your-build-for-package-visibility-in-android-11.html
- AGP 4.1.0以上のバージョンを使用する場合は、AGPのアップグレードは行わなくても構いません。
If you are using the Android Gradle plugin version... |
...upgrade to: | Unity Editor |
---|---|---|
4.1.* | N/A (no upgrade needed) | - |
4.0.* | 4.0.1 | - |
3.6.* | 3.6.4 | 2020.1 ~ |
<manifest>
<!-- [Android11] settings start -->
<queries>
<!-- [All SDK] AppToWeb Authenthcation support start -->
<package android:name="com.android.chrome" />
<package android:name="com.chrome.beta" />
<package android:name="com.chrome.dev" />
<package android:name="com.sec.android.app.sbrowser" />
<!-- [All SDK] AppToWeb Authenthcation support end -->
<!-- [Facebook] Configurations begin -->
<package android:name="com.facebook.katana" />
<!-- [Facebook] Configurations end -->
<!-- [PAYCO/Hangame] Configurations begin -->
<package android:name="com.nhnent.payapp" />
<!-- [PAYCO/Hangame] Configurations end -->
<!-- [Hangame] Configurations begin -->
<package android:name="com.nhn.hangameotp" />
<package android:name="com.sci.siren24.ipin" />
<package android:name="kr.co.samsungcard.mpocket" />
<package android:name="com.lcacApp" />
<package android:name="com.shcard.smartpay" />
<package android:name="com.hyundaicard.appcard" />
<package android:name="com.kbcard.cxh.appcard" />
<package android:name="com.hanaskcard.paycla" />
<package android:name="kvp.jjy.MispAndroid320" />
<package android:name="nh.smart.nhallonepay" />
<!-- [Hangame] Configurations end -->
<!-- [NAVER] Configurations begin -->
<package android:name="com.nhn.android.search" />
<!-- [NAVER] Configurations end -->
<!-- [Weibo] Configurations begin -->
<package android:name="com.weico.international" />
<package android:name="com.sina.weibo" />
<!-- [Weibo] Configurations end -->
<!-- [ONE store] Configurations begin -->
<!-- Android 2.60.0以上からはONE store queries宣言が必要ありません。 -->
<intent>
<action android:name="com.onestore.ipc.iap.IapService.ACTION" />
</intent>
<intent>
<action android:name="android.intent.action.VIEW" />
<data android:scheme="onestore" />
</intent>
<!-- [ONE store] Configurations end -->
<!-- [Galaxy store] Configurations begin -->
<package android:name="com.sec.android.app.samsungapps" />
<!-- [Galaxy store] Configurations end -->
</queries>
<!-- [Amazon Appstore] Configuration begin -->
<uses-permission
android:name="android.permission.QUERY_ALL_PACKAGES"
tools:ignore="QueryAllPackagesPermission" />
<!-- [Amazon Appstore] Configuration end -->
<!-- [Android11] settings end -->
</manifest>
[注意]
- QUERY_ALL_PACKAGES権限はAmazon Appstore専用宣言のため、Google Playビルド時には適用しないようにご注意ください。
GamebaseでサポートしないAPIは、使用していないもの(deprecate)として処理します。 使用していない(deprecated) APIは、次の条件を満たす場合、事前告知を行わずに削除されることがあります。