Android

Hive SDK Android 認証設定ガイド

機能の追加¶

モジュールレベルのbuild.gradleファイルに対応する外部ライブラリを追加する必要があります。使用する認証機能のみを追加してください。

以下は、モジュールレベルのbuild.gradleファイルに外部ライブラリを追加する例です。

dependencies {
   // Feature-specific settings. Add only the features you are using.
   // AuthV4 Device Management Service
   implementation "com.com2us.android.hive:hive-authv4-device-management"
   // AuthV4 Google In-App Update
   implementation "com.com2us.android.hive:hive-authv4-google-inappupdate"
   // AuthV4 Google reCAPTCHA
   implementation "com.com2us.android.hive:hive-authv4-google-recaptcha"
   // AuthV4 Real Name Verification (China)
   implementation "com.com2us.android.hive:hive-authv4-real-name-verification"
}

IdPの追加¶

モジュールレベルのbuild.gradleファイルに外部ライブラリを追加します。使用するIdPのみを追加してください。

以下は、モジュールレベルの build.gradle ファイルに外部ライブラリを追加する例です。ライブラリを追加せずにゲストログイン機能を使用できます。

dependencies {
    // IdP-specific settings. Add only the IdPs you are using.

    // Apple Login
    implementation "com.com2us.android.hive:hive-authv4-provider-apple-signin"

    // Facebook Login
    implementation "com.com2us.android.hive:hive-authv4-provider-facebook"

    // Google Play Games Login
    // `hive-authv4-provider-google-playgames` includes the `play-service-games-v2` library.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-playgames"

    // Google Login
    // Google Play Games Login and Google Login are different login methods.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-signin"

    // Hive Membership Login
    implementation "com.com2us.android.hive:hive-authv4-provider-hive-membership"

    // Huawei Login
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei"

    // LINE Login
    // To apply the LINE library, minSdkVersion 24 or higher is required.
    implementation "com.com2us.android.hive:hive-authv4-provider-line"

    // QQ Login
    implementation "com.com2us.android.hive:hive-authv4-provider-qq"

        // Steam Login
        implementation "com.com2us.android.hive:hive-authv4-provider-steam"

    // VK library requires targetSdkVersion 32 or higher.
    implementation "com.com2us.android.hive:hive-authv4-provider-vk"

    // WeChat Login
    implementation "com.com2us.android.hive:hive-authv4-provider-wechat"

    // Weverse Login
    implementation "com.com2us.android.hive:hive-authv4-provider-weverse"

        // X Login
    implementation "com.com2us.android.hive:hive-authv4-provider-x"

    // Telegram Login
    implementation "com.com2us.android.hive:hive-authv4-provider-telegram"
}

IdPによる追加設定¶

IdPに応じて追加の設定が必要です。

Google Play ゲームサインイン IdP 設定¶

Google Play Gamesログインを使用するには、次のように設定します。

AndroidManifest.xml の設定¶

これはGoogle Playサービスの設定です。これらはGoogle Playゲームログイン設定に必要な値です。

<manifest>
    <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id"/>
    </application>
</manifest>

hive_config.xml の設定¶

hive_config.xmlで、playAppIdとserverClientIdを<providers>タグ内の<google>タグに設定します。

Facebook IdP 設定¶

Facebookログインを使用するには、AndroidManifest.xmlで必要な設定を行ってください。

まず、アプリからリンク、画像、またはビデオを共有するためにFacebookContentProviderを設定します。android:authorities属性に、Facebook AppIDをcom.facebook.app.FacebookContentProviderに追加します。

例: FacebookのAppIDが123456789のとき

<provider android:authorities="com.facebook.app.FacebookContentProvider123456789" />

Facebook AppIdとクライアントトークン設定（Facebook v13以上に必要）の設定を追加します。

例: Facebook AppIDが123456789のとき

<meta-data
    android:name="com.facebook.sdk.ApplicationId"
    android:value="fb123456789"/>

例: Facebookクライアントトークンが123456789のとき

<meta-data
    android:name="com.facebook.sdk.ClientToken"
    android:value="fb123456789"/>

Note

Facebook AppIdとクライアントトークンは、string.xmlファイルにも設定できます。この場合、android:valueを設定する際にfbプレフィックスは必要ありません。詳細については、こちらを参照してください。

QQ/Wechat IdP 設定¶

QQまたはWeChat IdPをサポートする場合は、以下の内容を追加してください。

モジュールレベルのbuild.gradleファイルでlibsフォルダーへの依存関係を設定します。

dependencies {
   implementation fileTree(include: ['*.jar'], dir: 'libs')
   implementation fileTree(include: ['*.aar'], dir: 'libs')
}

モジュールレベルのlibsフォルダーに外部ライブラリ(.aar/.jar)をHive SDK配布バージョンに追加します。配布バージョンに含まれる外部ライブラリのリストは以下の通りです。

mid-sdk-2.10.jar (QQ IdP ログインをサポートする際にこのファイルを追加してください)
mta-sdk-2.0.0.jar (QQ または Wechat IdP ログインをサポートする際にこのファイルを追加してください)
open_sdk_3.5.4.11_r3f56456_lite.jar (QQ IdP ログインをサポートする際にこのファイルを追加してください)

VK IdP 設定¶

VKコンソールから発行されたアプリIDを/res/values/strings.xmlファイルに設定します。

<integer name="com_vk_sdk_AppId">your_app_id</integer>

Huawei IdP 設定¶

agconnect-services.jsonを追加する
- Huaweiコンソールからダウンロードしたagconnect-services.jsonファイルをプロジェクトフォルダーに追加します。

プロジェクト - build.gradleファイルの設定

AppGallery ConnectプラグインとMavenアドレスを追加します。

buildscript {
    repositories {
        google()
        jcenter()
        // Huawei HMS Core SDK.
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        // Huawei AppGallery Connectプラグイン
        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
    }
}
allprojects {
    repositories {
        google()
        jcenter()
        /// Huawei HMS Core SDK.
        maven {url 'https://developer.huawei.com/repo/'}
    }
}

アプリ - build.gradleファイルの設定

Huawei認証ライブラリとプラグインを追加します。

dependencies {
    // Huawei依存関係
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei" // Huawei認証
}
apply plugin: 'com.huawei.agconnect'