カスタマーサービス¶

カスタマーサービスは、ゲームやプラットフォームを使用中に発生する問い合わせや問題について、1:1で担当者に連絡し、回答を受けることができるシステムです。

お問い合わせ¶

1:1のお問い合わせは、Hive SDKによって提供されるカスタマーサービスポータルで、FAQやお問い合わせオプションなどの機能を提供しています。このお問い合わせ機能は、ゲーム内だけでなく、モバイルおよびPCのウェブサイトでも同様の機能を提供できます。

Hive SDKは、アプリ内のウェブビューで1:1の問い合わせを公開する機能を提供します。1:1の問い合わせを公開するには、以下の手順に従う必要があります。

開発者は、アプリ内で1:1の問い合わせを公開できるボタンまたはUI要素を実装します。\n
ユーザーがアプリ内でこのボタンまたはUI要素を選択すると、アプリはHive SDKの認証機能を利用してAuthV4.showInquiryを呼び出します。

AuthV4.showInquiryを呼び出すと、Hive SDKによって提供された問い合わせ画面が表示されます。ユーザーは問い合わせ画面でゲームの問い合わせを登録できます。

1:1の問い合わせに対する露出を実装する際に留意すべきポイントを以下に示します。

Hive プレイヤーID (CSコード) は、ユーザーが問い合わせを登録する際にアプリのUIに表示される必要があります。
ユーザーはゲストログイン状態でも利用できるべきです。
カスタマーサービスセンターのリンクを表示する規則は、ゲームの出版会社によって異なる場合があります。
1:1問い合わせボタンを除いて、アプリ開発者の電話番号やメールアドレスを表示することはポリシーにより許可されていません。

これは連絡先フォームを公開する例のコードです。

UnityC++KotlinJavaスウィフトObjective-Cアンリアルエンジン

APIリファレンス: AuthV4.showInquiry

using hive;    
    AuthV4.showInquiry((ResultAPI result) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

APIリファレンス: AuthV4 ::showInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    AuthV4::showInquiry([=](ResultAPI const & result) {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

APIリファレンス: AuthV4.showInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;
    AuthV4.showInquiry(object : AuthV4.AuthV4ShowInquiryListener {    
         override fun onAuthV4ShowInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: AuthV4.INSTANCE.showInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    AuthV4.INSTANCE.showInquiry(result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

APIリファレンス: AuthV4Interface .showInquiry

import HIVEService    
    AuthV4Interface.showInquiry() { result in    
    if result.isSuccess() {    
    // call successful    
    }    
}

API リファレンス: [ HIVEAuthV4 showInquiry]

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEAuthV4 showInquiry: ^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
    // call successful    
    }    
}];

#include "HiveAuthV4.h"

FHiveAuthV4::ShowInquiry(FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // 成功しました
        }
}));

私の問い合わせ履歴 (Hive メンバーシップ IdP 専用)¶

Hive メンバーシップ IdP を統合する際、ユーザーは「マイ問い合わせ履歴」ショートカットを通じて提出した問い合わせを迅速に確認できます。 Hive SDK は、アプリ内のウェブビューに「マイ問い合わせ履歴」を表示する機能を提供します。問い合わせ履歴を表示するには、以下の手順に従う必要があります。

開発者は、私の問い合わせ履歴を表示できるボタンまたはUI要素をアプリに実装します。
ユーザーがアプリ内でこのボタンまたはUI要素を選択すると、アプリはHive SDKの認証機能を利用してAuthV4.showMyInquiryを呼び出します。

AuthV4.showMyInquiryを呼び出すと、Hive SDKによって提供された私の問い合わせ履歴が公開されます。

私の問い合わせ履歴が利用できない場合¶

以下は、AuthV4.showMyInquiryを呼び出すことができないケースです。

ユーザーがアプリ内のHiveメンバーシップの代わりにFacebookやGoogleなどの他のIdPとリンクした後にAuthV4.showInquiryを呼び出して1:1のお問い合わせを作成する場合
ユーザーがアプリ内でどのIdPにもログインしていない状態でAuthV4.showInquiryを呼び出して1:1のお問い合わせを作成する場合
ユーザーがウェブブラウザを介してカスタマーサービスページにアクセスし、1:1のお問い合わせを作成する場合

上記の状況2および3では、ユーザーが1:1の問い合わせを書き、アプリでHiveのメンバーシップIdPアカウントでログインした後、AuthV4.showMyInquiryを呼び出しても、問い合わせ履歴を取得できません。

これは私の問い合わせ履歴を公開する例のコードです。

UnityC++KotlinJavaスウィフトObjective-Cアンリアルエンジン

APIリファレンス: hive.AuthV4 .showMyInquiry

using hive;    
    AuthV4.showMyInquiry((ResultAPI result) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

APIリファレンス: AuthV4:: showMyInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    AuthV4::showMyInquiry([=](ResultAPI const & result) {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

APIリファレンス: AuthV4.showMyInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;    
    AuthV4.showMyInquiry(object : AuthV4.AuthV4ShowMyInquiryListener {    
         override fun onAuthV4ShowMyInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: com.hive .AuthV4.showMyInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    AuthV4.INSTANCE.showMyInquiry(result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

APIリファレンス: AuthV4Interface .showMyInquiry

import HIVEService    
    AuthV4Interface.showMyInquiry() { result in    
    if result.isSuccess() {    
    // call successful    
    }    
}

APIリファレンス: HIVEAuthV4:: showMyInquiry

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEAuthV4 showMyInquiry: ^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
    // call successful    
    }    
}];

#include "HiveAuthV4.h"

FHiveAuthV4::ShowMyInquiry(FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // Call succeeded
        }
}));

チャットボット¶

Hive SDKは、顧客がチャットボットで問い合わせを行う機能を提供します。

チャットボットへの連絡¶

Hive SDKは、アプリ内のウェブビューにチャットボットの問い合わせを表示する機能を提供します。チャットボットの問い合わせを表示するには、以下の手順に従う必要があります。

開発者は、アプリ内でチャットボットの問い合わせを表示できるボタンまたはUI要素を実装します。
ユーザーがアプリ内でこのボタンまたはUI要素を選択すると、アプリはHive SDKの認証機能を利用してAuthV4.showChatbotInquiryを呼び出します。

これはチャットボットの問い合わせを公開する例のコードです。

UnityC++KotlinJavaスウィフトObjective-Cアンリアルエンジン

APIリファレンス: hive .AuthV4.showChatbotInquiry

using hive;    
    // チャットボットページショートカットAPIを呼び出すときに配信されることが約束されたJSON形式の文字列データ    
    String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4.showChatbotInquiry(additionalInfo, (ResultAPI result) => {    
         if (result.isSuccess()) {    
             // 呼び出し成功    
         }    
});

API リファレンス: AuthV4 ::showChatbotInquiry

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    // チャットボットページショートカットAPIを呼び出す際に提供されるJSON形式の文字列データ    
    string additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4::showChatbotInquiry(additionalInfo, [=](ResultAPI const &result) {    
         if (result.isSuccess()) {    
            // 呼び出し成功    
         }    
});

APIリファレンス: AuthV4.showChatbotInquiry

import com.hive.AuthV4;
    import com.hive.ResultAPI;
    // チャットボットページショートカットAPIを呼び出すときに配信されることが約束されたJSON形式の文字列データ    
    val additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"    
    AuthV4.showChatbotInquiry(additionalInfo, object : AuthV4.AuthV4ShowChatbotInquiryListener {    
         override fun onAuthV4ShowChatbotInquiry(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // 呼び出し成功    
             }    
         }    
})

APIリファレンス: com.hive .AuthV4.showChatbotInquiry

import com.hive.AuthV4;    
    import com.hive.ResultAPI;    
    // チャットボットページショートカットAPIを呼び出すときに提供されることが約束されたJSON形式の文字列データ    
    String additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }";    
    AuthV4.INSTANCE.showChatbotInquiry(additionalInfo, result -> {    
         if (result.isSuccess()) {    
             // 呼び出し成功    
         }    
});

APIリファレンス: AuthV4Interface.showChatbotInquiry

import HIVEService    
    // チャットボットページショートカットAPIを呼び出すときに提供されることが約束されたJSON形式の文字列データ    
    let additionalInfo = "{ \"init_path\":\"hive_sdk_api\" }"    
    AuthV4Interface.showChatbotInquiry(additionalInfo) { result in    
    if result.isSuccess() {    
    // 呼び出し成功    
    }    
}

APIリファレンス: HIVEAuthV4:: showChatbotInquiry

#import <HIVEService/HIVEService-Swift.h>    
    // チャットボットページショートカットAPIを呼び出すときに配信されることが約束されたJSON形式の文字列データ    
    NSString *additionalInfo = @"{ \"init_path\":\"hive_sdk_api\" }";    
    [HIVEAuthV4 showChatbotInquiry:additionalInfo handler:^(HIVEResultAPI *result) {    
    if ([result isSuccess]) {    
             // 呼び出し成功    
         }    
}];

#include "HiveAuthV4.h"

// チャットボットページショートカットAPIを呼び出す際に送信される約束されたJSON形式の文字列データ
TSharedPtr<FJsonObject> AdditionalInfoJson = MakeShareable(new FJsonObject);
AdditionalInfoJson->SetStringField(TEXT("init_path"), TEXT("hive_sdk_api"));

FString StrAdditionalInfo;
TSharedRef<TJsonWriter<>> JsonWriter = TJsonWriterFactory<>::Create(&StrAdditionalInfo);
FJsonSerializer::Serialize(AdditionalInfoJson.ToSharedRef(), JsonWriter);

FHiveAuthV4::ShowChatbotInquiry(StrAdditionalInfo, FHiveAuthV4OnShowInquiryDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // Call succeeded
        }
}));

additionalInfoは文字列型定数("{ \"init_path\":\"hive_sdk_api\" }")、これはチャットボットページが表示されるときに送信されるデータです。

Appdelegateの設定 (ios)¶

チャットボットで使用されるAppDelegateは、iOSアプリのトップレベルオブジェクトで発生する共通の動作（メソッド）を定義するクラスであり、Xcodeプロジェクトを使用してビルドすると自動的に生成されます。Hive SDKは、ユーザーの利便性のためにチャットボットUIをポートレート固定の方法で公開し、この機能がiOSで正しく機能するためには、ゲームエンジンのAppDelegateクラスの画面回転に関連するメソッドapplication(_:supportedInterfaceOrientationsFor:)を以下のように実装する必要があります。

オブジェクティブ-Cスウィフト

// ゲームエンジンがObjective-Cで作成されている場合、以下のAppDelegate関数を実装します
- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window 
{
    // TODO: 横向き専用ゲームの場合
    return UIInterfaceOrientationMaskLandscape;
    // TODO: 縦向き専用ゲームの場合
    return UIInterfaceOrientationMaskPortrait;
    // TODO: 横向きと縦向きを両方サポートするゲームの場合
    return UIInterfaceOrientationMaskAll;
}

// Swiftで作られたゲームエンジンの場合、以下のAppDelegate関数を実装します
func application(_ application: UIApplication, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask 
{
    // TODO: 横向き専用のゲームの場合
    return [.landscape]
    // TODO: 縦向き専用のゲームの場合
    return [.portrait]
    // TODO: 横向きと縦向きを両方サポートするゲームの場合
    return .all
}

上記のメソッドの戻り値は、ゲームに適用されるUIInterfaceOrientationMask値として返されます。横向き専用のゲームの場合、横向きを返し、縦向き専用のゲームの場合は縦向きを返します。また、横向きと縦向きを両方サポートするゲームの場合は横向きと縦向きの両方を返します。

Warning

Unityエンジンはすでに画面回転に関連するAppDelegateメソッドを実装しており、Xcodeプロジェクトを通じてビルドすると自動的に生成されます。言い換えれば、Unityでゲームを開発している場合、上記の例のコードでapplication(_:supportedInterfaceOrientationsFor:)メソッドを実装する必要はありません。

iPadでチャットボット画面を縦向きで表示したい場合は、以下の追加設定をXcodeで適用し、その後ビルドしてください。