本人確認サービス

Hive SDKは、成人認証および親の同意のための身分確認サービスを提供します。

成人認証¶

「青少年向けではない」と評価されたゲームは、19歳未満の未成年者のアクセスを制限しなければなりません。 Hive は、モバイル電話認証を通じて成人認証を提供し、認証された成人のみがゲームにアクセスできるようにします。この認証は1年間有効で、その後は自動的に再認証が必要です。

成人認証のためのコード実装は必要ありません。Hive Consoleで機能を有効にするだけです。有効にすると、ログイン時に成人認証が行われます。

成人認証失敗に関する応答¶

未成年者が成人認証を試みて失敗した場合、応答はResultAPI.CANCELED(-6)、ResultAPI.Code.AgeLimit(-1200067)、および"年齢制限により失敗しました。"になります。この応答を使用して、ゲーム内で未成年のユーザーを必要に応じてガイドできます。

DIハッシュ値の取得¶

成功した成人認証の後、AuthV4.getHashedDiメソッドを使用して、認証されたユーザーを識別するハッシュ化されたDI（重複参加確認情報）値を取得します。DIはセキュリティのためにハッシュ化されており、この値を直接使用できます。DIハッシュはログイン後にPlayerIDにリンクされるため、認証されたユーザーの識別子として使用できます。以下は、PlayerIDにリンクされたDIハッシュを取得する例です：

using hive;    
AuthV4.getHashedDi((ResultAPI result, String hashedDi) => {    
    if (result.isSuccess()) {    
        // API call successful 
    } else {
        // Called before NEED_INITIALIZE setup
        // Called before INVALID_SESSION signIn
        // DEVELOPER_ERROR, CommonLibraryMissing: Failed to reference adult authentication library
    }
});

#include "HiveAuthV4.h"

FHiveAuthV4::getHashedDi(FHiveAuthV4OnHashedDiDelegate::CreateLambda([this](const FHiveResultAPI& Result, FString& hashedDi) {
    if (Result.IsSuccess()) {
        // API呼び出し成功
    } else {
        // NEED_INITIALIZEセットアップ前に呼び出されました
        // INVALID_SESSIONサインイン前に呼び出されました
        // DEVELOPER_ERROR, CommonLibraryMissing: 大人認証ライブラリの参照に失敗しました
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;    
AuthV4::getHashedDi([=](ResultAPI result, string hashedDi) {    
    if (result.isSuccess()) {    
        // API call successful    
    } else {
        // Called before NEED_INITIALIZE setup
        // Called before INVALID_SESSION signIn
        // DEVELOPER_ERROR, CommonLibraryMissing: Failed to reference adult authentication library
    }   
});

import com.hive.AuthV4    
import com.hive.ResultAPI    

AuthV4.getHashedDi(object : AuthV4.AuthV4GetHashedDiListener {    
    override fun onAuthV4GetHashedDi(result: ResultAPI, hashedDi: String?) {    
        if (result.isSuccess) {    
            // API呼び出し成功    
        } else {
            // NEED_INITIALIZEセットアップの前に呼び出されました
            // INVALID_SESSIONサインインの前に呼び出されました
            // DEVELOPER_ERROR, CommonLibraryMissing: 大人認証ライブラリの参照に失敗しました
        } 
    }    
})

import com.hive.AuthV4;    
import com.hive.ResultAPI;    

AuthV4.getHashedDi(result, hashedDi -> {    
    if (result.isSuccess()) {    
        // API呼び出し成功    
    } else {
        // NEED_INITIALIZEセットアップの前に呼び出されました
        // INVALID_SESSIONサインインの前に呼び出されました
        // DEVELOPER_ERROR, CommonLibraryMissing: 大人認証ライブラリの参照に失敗しました
    }
});

import HIVEService

AuthV4Interface.getHashedDi() { result, hashedDi in    
    if result.isSuccess() {    
        // API呼び出し成功    
    } else {
        // NEED_INITIALIZEセットアップの前に呼び出されました
        // INVALID_SESSIONサインインの前に呼び出されました
        // DEVELOPER_ERROR, CommonLibraryMissing: 大人認証ライブラリの参照に失敗しました
    }
}

#import <HIVEService/HIVEService-Swift.h>

[HIVEAuthV4 getHashedDi: ^(HIVEResultAPI *result, NSString *> *hashedDi) {    
    if ([result isSuccess]) {    
        // APIコール成功    
    } else {
        // NEED_INITIALIZEセットアップ前に呼び出されました
        // INVALID_SESSIONサインイン前に呼び出されました
        // DEVELOPER_ERROR, CommonLibraryMissing: 大人認証ライブラリの参照に失敗しました
    }
}];

親の同意¶

青少年保護法に基づき、19歳未満のユーザーは、ゲームにサインアップして使用するために親の同意を得る必要があります。Hive SDKは、モバイル電話認証を通じてPCゲームのサインアップのための親の同意を取得する機能を提供します。カスタマーサポートや親へのゲーム使用詳細の提供のために、SDKは未成年者の生年月日と親のメールアドレスをアプリに提供します。

親の同意情報を取得する¶

親の同意情報を取得するには、親の同意が完了した後にgetParentalConsentInfo()メソッドを呼び出します。このメソッドは、未成年者の生年月日と同意時に提供された親のメールアドレスを返します。

親の同意情報を取得するための例のコード:

using hive;    

    AuthV4.ParentalConsentInfo parentalConsentInfo = AuthV4.getParentalConsentInfo();    

#include "HiveAuthV4.h"

TOptional<FHiveParentalConsentInfo> ParentalConsentInfo = FHiveAuthV4::GetParentalConsentInfo();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    

    AuthV4::ParentalConsentInfo parentalConsentInfo = AuthV4::getParentalConsentInfo();