リモートプッシュの送信

Hive SDKは、リモートプッシュを送信し、プッシュ設定を検索および変更するための機能を提供します。ゲーム開発者が行うべきことは、ユーザーがプッシュサービスにオプトインまたはオプトアウトできる設定UIを作成することです。

リモートプッシュの送信¶

リモートプッシュは、Hive コンソールから、またはゲームサーバーから Hive サーバーへのAPI呼び出しによって送信されます。したがって、リモートプッシュを送信または受信するために、ゲームクライアントで行う必要があることはありません。

詳細については、以下のリンクをクリックしてください。

プッシュ設定の検索¶

Hive SDKは、ユーザーのリモートプッシュ設定状況に関する以下の内容を持つRemotePushクラスを定義しています。

名前	タイプ	説明
isAgreeNotice	ブール値	ユーザーが設定したお知らせ通知の有効化状態を説明します `true`: ユーザーはお知らせ通知に参加しました `false`: ユーザーはお知らせ通知をオプトアウトしましたインストール履歴が存在しない場合: `true` サーバーから値がない場合: `true`
isAgreeNight	ブール値	ユーザーが設定した夜間通知の有効化状態を説明します `true`: ユーザーは夜間通知に参加しました `false`: ユーザーは夜間通知をオプトアウトしましたインストール履歴が存在しない場合: 韓国; `false`, 韓国以外の国; `true` サーバーから値がない場合: `false`

ユーザーのリモートプッシュステータスに関する情報をHiveサーバーに保存されているものから検索するには、PushクラスのgetRemotePush()メソッドを呼び出し、検索の結果として返されるRemotePushオブジェクトを確認します。以下はリモートプッシュの設定を検索するためのサンプルコードです。

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

APIリファレンス: hive.Push.getRemotePush

using hive;    
    Push.getRemotePush((ResultAPI result, RemotePush remotePush) => {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

#include "HivePush.h"

FHivePush::GetRemotePush(FHivePushOnRemotePushDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveRemotePush& RemotePush) {
        if (Result.IsSuccess()) {
                // API呼び出し成功
        }
}));

API リファレンス: Push::getRemotePush

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Push::getRemotePush([=](ResultAPI result, RemotePush remotePush) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

API リファレンス: Push.getRemotePush

import com.hive.Push    
    import com.hive.ResultAPI    
    Push.getRemotePush(object : Push.RemotePushListener {    
         override fun onPushToken(result: ResultAPI, remotePush: Push.RemotePush?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: com.hive.Push.getRemotePush

import com.hive.Push;    
    import com.hive.ResultAPI;    
    Push.INSTANCE.getRemotePush((result, remotePush) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

APIリファレンス: PushInterface .getRemotePush

import HIVEService    
    PushInterface.getRemotePush() { result, remotePush in    
        if result.isSuccess() {    
        // call successful    
        }    
}

APIリファレンス: HIVEPush:getRemotePush

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPush getRemotePush: ^(HIVEResultAPI *result, HIVERemotePush *remotePush) {    
        if ([result isSuccess]) {    
        // call successful    
        }    
}];

プッシュ設定の変更¶

ユーザーがお知らせ通知または夜間通知のステータスを変更した場合、更新されたデータをHiveサーバーに送信する必要があります。Hiveサーバーに更新されたデータを送信するには、データをremotePushパラメータ（RemotePushオブジェクト）に設定し、PushクラスのsetRemotePush()メソッドを呼び出し、その後コールバック関数で結果を確認します。以下は、広告のプッシュ設定を変更するためのサンプルコードです。

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

APIリファレンス: hive.Push.setRemotePush

using hive;    
    RemotePush remotePush = new RemotePush();    
    remotePush.isAgreeNotice = true;    
    remotePush.isAgreeNight = false;    

    Push.setRemotePush(remotePush, (ResultAPI result, RemotePush remotePush) => {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

#include "HivePush.h"

bool bNotice = true;
bool bNight = false;
FHiveRemotePush RemotePush(bNotice, bNight);

FHivePush::SetRemotePush(RemotePush, FHivePushOnRemotePushDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveRemotePush& RemotePush) {
        if (Result.IsSuccess()) {
                // API呼び出し成功
        }
}));

APIリファレンス: Push::setRemotePush

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    HIVERemotePush remotePush;    
    remotePush.isAgreeNotice = true;    
    remotePush.isAgreeNight = false;    

    Push::setRemotePush(remotePush, [=](resultAPI result, HIVERemotePush remotePush) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

APIリファレンス: Push.setRemotePush

import com.hive.Push    
    import com.hive.ResultAPI    
    val remotePush = Push.RemotePush()    
    remotePush.isAgreeNotice = true    
    remotePush.isAgreeNight = false    
    Push.setRemotePush(remotePush, object : Push.RemotePushListener {    
         override fun onPushToken(result: ResultAPI, remotePush: Push.RemotePush?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: com.hive.Push.setRemotePush

import com.hive.Push;    
    import com.hive.ResultAPI;    
    Push.RemotePush remotePush = new Push.RemotePush();    
    remotePush.setAgreeNotice(true);    
    remotePush.setAgreeNight(false);    
    Push.INSTANCE.setRemotePush(remotePush, (result, remotePush1) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API リファレンス: PushInterface.setRemotePush

import HIVEService    
    let remotePush = RemotePush()    
    remotePush.isAgreeNotice = true    
    remotePush.isAgreeNight = false    
    PushInterface.setRemotePush(remotePush) { result, remotePush in    
        if result.isSuccess() {    
        // call successful    
        }    
}

APIリファレンス: HIVEPush:setRemotePush

#import <HIVEService/HIVEService-Swift.h>    
    HIVERemotePush *remotePush = [[HIVERemotePush alloc] init];    
    remotePush.isAgreeNotice = YES;    
    remotePush.isAgreeNight = NO;    

    [HIVEPush setRemotePush: remotePush handler: ^(HIVEResultAPI *result, HIVERemotePush *remotePush){    
        if ([result isSuccess]) {    
        // 成功を呼び出す    
        }    
}];