コンテンツにスキップ

認証の使用方法

このページでは認証 v4を紹介します。これはHiveプラットフォームの新しい認証システムで、Hive SDK v4.3.0から利用可能です。認証 v4は、Hive SDKの初期化からログインまでの一連のプロセスを管理します。

Note

Authentication v1を使用してゲームを開発したい場合は、Authentication v1メニューを使用したSDK v4による開発を参照してください。

構成

認証は三つのステップで構成されています。

  1. Hive SDKの初期化
    • SDKを初期化した後、Hive SDKが提供するすべての機能を使用できます。
    • 初期化フェーズでは、利用規約や更新/通知ポップアップが表示されます。
    • 初期化フェーズでは、Androidベースのデバイスのみで権限ポップアップが表示されます。
  2. ゲームサーバー選択メニューとメンテナンスポップアップの表示
    • SDKの初期化後にユーザーにゲームサーバー選択メニューを提供します。
    • ゲームサーバーの選択後にサーバーメンテナンスポップアップを表示します。
  3. サインイン
    • Hive メンバーシップと多様なID プロバイダー（IdP）を使用して、Authentication v4を通じてゲームにサインインできます。

機能

  • 認証は、Apple Game Center、Google Play Games、およびFacebookなどの多様なIdPに適用するために柔軟です。
    • Facebookなどのソーシャルメディアアカウントでのサインインは、Hive メンバーシップに関係なく利用可能です。
    • ユーザーのデバイスに設定されたApple Game CenterまたはGoogle Play Gamesアカウントを使用して、暗黙のログインが可能です。
  • 認証およびサインイン手続きのためのカスタマイズされたUIをサポートしています。
    • 必要に応じて、Hive SDKが提供するUIを使用するのではなく、ゲームコンセプトに従って与えられたAPIを使用して新しいUIを設計します。
  • 分散サーバーを通じて安定したサインインをサポートしています。
    • 国際インターネット回線に問題がある場合や、Hive サーバーが故障している場合でも、韓国以外のサーバーを使用してゲームにログインできます。

認証ヘルパー v4

Hive SDK v4.7.0 は、AuthV4.Helperを提供します。これは、迅速かつ簡単なサインインを実装するための新機能です。

  • ゲームを実行するためのアカウントと、ユーザーのデバイスでサインインするためのアカウントを比較するアップグレードされたAPIを見つけることができます。
    • デバイス上のGoogle Play GameまたはApple Game Centerのアカウントは、PlayerIDと同期されたアカウントと比較されます。
  • ゲームからデータを確認する必要はなく、SDKファイルを確認するだけです。
    • 適切なIDプロバイダー（IdP）は、国のデータを検証することによって表示されます。 （例：国情報が中国（CN）の場合、ゲストアカウントはIdPリストから隠されます。）
    • 適切なIdPは、デバイスのOSタイプを特定することによって表示されます。 （例：デバイスのOSタイプがGoogleに基づいていて、国情報が中国（CN）の場合、Google Play GameはIdPリストから隠されます。）
  • Hive SDKとの同期のための簡略化されたガイドラインを実行できます。
    • ガイドラインに従うためにHive Server APIで実装する必要のない部分が排除されました。
    • このアップデートにより、Hive Server APIを使用するよりも理解しやすく、実装しやすくなります。

利用可能なプロバイダー

以前に説明したように、 認証 v4 はユーザーを IdP で検証します。ユーザーは、以前に同期された IdP を使用することも、サインインアカウントにリンクするために他のものを選択することもできます。提供された IdP はゲームに応じて異なる設定が可能であり、Hive プラットフォームはユーザーの国情報に応じて適切な IdP をユーザーに提供します。

認証 v4 で提供される IdP

IdP 説明 エクスポージャ条件 / サポートされているバージョン
Hive Membership Hiveメンバーアカウントのメールとパスワードでユーザーを認証 特別な条件なし
Facebook Facebookアカウントで認証 ユーザーの国が中国（CN）の場合は表示されません
Google Play Games Google Play Gamesプロファイルアカウントで認証（Googleログインとは異なる） Androidのみ。ユーザーの国が中国の場合は表示されません
Google Googleメールアカウントで認証（Android以外のiOSや他のプラットフォームをサポート） ユーザーの国が中国の場合は表示されません。Androidでは、GoogleとGoogle Play Gamesは同時に表示可能 — アイコンで区別: icon
Game Center Apple Game Centerアカウントで認証 iOSのみ表示
QQ Tencent QQアカウントで認証 ユーザーの国が中国の場合またはゲーム言語が簡体字中国語の場合のみ表示。QQログインはHive SDK v4.5.0からサポート
VK VKアカウントで認証 ゲーム言語がロシア語の場合のみ表示。ユーザーの国が中国の場合は表示されません。VKログインはHive SDK v4.6.0からサポート
WeChat WeChatアカウントで認証 ユーザーの国が中国の場合またはゲーム言語が簡体字中国語の場合のみ表示。WeChatログインはHive SDK v4.6.0からサポート
Apple Appleアカウントで認証 iOS 13+で表示。AppleログインはHive SDK v4.11.7.3からサポート
SignInWithApple AndroidでAppleアカウントで認証 Android API 21+でサポート。Hive SDK v4.15.6からサポート
LINE LINEアカウントで認証 Android SDK 17およびiOS 10+で表示。LINEログインはHive SDK v4.14.0からサポート
Weverse Weverseアカウントで認証 iOS 12+で表示。WeverseログインはHive SDK v4.15.2からサポート
Huawei Huaweiアカウントで認証 Androidのみ表示。HuaweiログインはHive SDK v4.16.2からサポート

ユーザー識別子

認証において、PlayerIDはユーザーを識別するためのユニークなキーです。 PlayerIDには以下の特徴があります：

  • さまざまなIdPと同期するために利用可能です。
  • 1つのPlayerIDには、1つのIdPのユーザーIDが1つしか持てません。
  • 1つのIdPのユーザーIDは、同じゲーム内で複数のPlayerIDとリンクできません。
  • 同じIdPアカウントであっても、ゲームごとに異なるPlayerIDが発行されます。
  • Authentication v4によって提供されるIdPのいずれとも同期していないユーザーは、ゲストユーザーです。

PlayerID の例

NO PlayerID ゲーム Hive メンバーシップ Facebook Google Play ゲーム ゲームセンター
1 10001 A X F10000 G10000 A10000
2 10002 A H10000 X G20000 X
3 20001 B H10000 X X X
4 20003 B X X X X
  • ユーザー番号1は、3つのIdPとPlayerIDを同期します; Facebook、Google Play Games、およびApple Game Center。
  • ユーザー番号1と2は、1つのゲームから異なる2つのユーザーIDのGoogle Play Gamesで各PlayerIDを同期します。
  • ユーザー番号2と3は、異なる2つのゲームのPlayerIDで同じHiveメンバーシップアカウントを同期します。
  • ユーザー番号4は、IdPのいずれとも同期していないゲストユーザーです。