เริ่มต้นใช้งาน

การตั้งค่าการผลักดัน¶

ผู้ใช้จะเห็นข้อกำหนดของข้อตกลงเมื่อเริ่มเล่นเกมครั้งแรกหลังจากติดตั้งแอป และจะดำเนินการตามกระบวนการยินยอมเพื่อรับการส่งเสริมการตลาดผ่านโฆษณา อย่างไรก็ตาม คุณควรให้ฟังก์ชันในการเลือกเข้าหรือออกจากบริการในหน้าการตั้งค่าเกมสำหรับผู้ที่ไม่ต้องการรับการแจ้งเตือนแบบพุช

ประเภทการตั้งค่า¶

ควรมีให้เลือกเข้าร่วมหรือไม่เข้าร่วมการแจ้งเตือนแบบพุชสำหรับ การแจ้งเตือนทั้งหมด, การแจ้งเตือนเกม, การแจ้งเตือนประกาศ และ การแจ้งเตือนตอนกลางคืน.

นโยบายการตั้งค่าการส่ง¶

1. ให้เมนูสำหรับผู้ใช้ในการเปิดหรือปิดบริการการแจ้งเตือนในเกม.

• การตั้งค่าการแจ้งเตือน

  • การแจ้งเตือนทั้งหมด จะปรากฏบนอุปกรณ์ Android และสามารถรวมรายละเอียดตามฟีเจอร์ของเกม
  • การแจ้งเตือนในเวลากลางคืนจะเปิดให้ผู้ใช้ในเกาหลีเท่านั้น
  • ค่าดีฟอลต์ของการตั้งค่าการแจ้งเตือนทั้งหมดและการแจ้งเตือนเกมคือ เปิด
  • ค่าดีฟอลต์ของการตั้งค่าการแจ้งเตือนประกาศและการแจ้งเตือนในเวลากลางคืนมาจาก Hive API

• เมนูการตั้งค่าการแจ้งเตือนเมื่อภาษาเกมเป็นภาษาเกาหลี
  (ตรวจสอบให้แน่ใจว่าแสดงการตั้งค่าการแจ้งเตือนในเวลากลางคืนบนอุปกรณ์ทั้งหมดรวมถึงแพลตฟอร์ม Android และ iOS)
  

  

• เมนูการตั้งค่าการแจ้งเตือนเมื่อภาษาของเกมไม่ใช่ภาษาเกาหลี ตัวอย่างสำหรับ Android

• คุณควรแสดงป๊อปอัพแบบทอสต์เป็นเวลาสองวินาทีเมื่อการตั้งค่าการแจ้งเตือนแบบพุชถูกเปลี่ยนแปลง.

• แสดงป๊อปอัพการแจ้งเตือน

  • เมื่อผู้ใช้เข้าสู่ระบบจากเกาหลี
  • เมื่อการตั้งค่าการแจ้งเตือนทั้งหมด, การแจ้งเตือน, การแจ้งเตือนในเวลากลางคืนเปลี่ยนแปลง (สำหรับการแจ้งเตือนเกม, ไม่แสดงป๊อปอัพแบบทูต)

• ข้อความสำหรับป๊อปอัพแบบทูต

  • เปิดใช้งานการแจ้งเตือนทั้งหมด: [ชื่อบริษัท] 2016.05.01 คุณได้เลือกที่จะรับการแจ้งเตือนทั้งหมด
  • ปิดการแจ้งเตือนประกาศ: [ชื่อบริษัท] 2016.05.01 คุณได้เลือกที่จะไม่รับการแจ้งเตือนประกาศ
  • เปิดใช้งานการแจ้งเตือนในเวลากลางคืน: [ชื่อบริษัท] 2016.05.01 คุณได้เลือกที่จะรับการแจ้งเตือนในเวลากลางคืน

• ตัวอย่างของการแจ้งเตือนแบบป๊อปอัพ

โปรดให้ข้อความการแจ้งเตือนสำหรับการตั้งค่าการส่งข้อความด่วน.

ในกรณีที่ผู้ใช้ไม่ได้รับการแจ้งเตือนแบบพุช แม้ว่าผู้ใช้จะเปิดใช้งานในเมนูการตั้งค่าการแจ้งเตือนแบบพุช โปรดให้คำแนะนำในการตรวจสอบการตั้งค่าการแจ้งเตือนของผู้ใช้ในเมนูการตั้งค่าของอุปกรณ์ การแจ้งเตือนแบบพุชจะไม่แสดงหากผู้ใช้เลือกที่จะไม่รับการแจ้งเตือนในการตั้งค่าของอุปกรณ์

• ตัวอย่างของข้อความบริการ Push

2. ใช้  Hive SDK API เพื่อ กำหนดค่า การตั้งค่าสำหรับการแจ้งเตือนที่ส่งผ่าน Hive Console.

• Hive คอนโซลส่งการแจ้งเตือนแบบพุชสองประเภท; การแจ้งเตือนประกาศและการแจ้งเตือนกลางคืน
• ค่าของตัวเลือกการแจ้งเตือนทั้งสองต้องถูกตั้งค่าเป็นค่าที่ตั้งไว้ใน Hive เซิร์ฟเวอร์
• คุณต้องส่งการเปลี่ยนแปลงไปยัง Hive เซิร์ฟเวอร์เมื่อทั้งสองตัวเลือกการแจ้งเตือนมีการเปลี่ยนแปลง
• สำหรับข้อมูลเพิ่มเติม โปรดดูที่ การส่งการแจ้งเตือนระยะไกล.

3. ใช้นโยบายการแจ้งเตือนในเวลากลางคืน

การแจ้งเตือนเวลากลางคืนเป็นของการแจ้งเตือนประกาศ กรุณาใช้แนวทางต่อไปนี้เมื่อดำเนินการตั้งค่าเมนูการแจ้งเตือนเวลากลางคืน

• หากผู้ใช้เลือกที่จะไม่รับการแจ้งเตือนประกาศ การแจ้งเตือนในเวลากลางคืนควรถูกปิดใช้งานโดยอัตโนมัติ
• เมื่อการแจ้งเตือนประกาศถูกปิดใช้งาน การแจ้งเตือนในเวลากลางคืนจะไม่สามารถเปิดใช้งานได้
• ถึงแม้ว่าผู้ใช้จะเลือกที่จะไม่รับการแจ้งเตือนประกาศ การแจ้งเตือนในเวลากลางคืนก็ไม่ควรเปิดใช้งานโดยอัตโนมัติ

การตั้งค่าการแสดงผลการผลักดัน¶

การแจ้งเตือนแบบพุชจะแสดงเมื่อแอปเกมของคุณไม่ได้ใช้งาน อย่างไรก็ตาม ด้วย Hive SDK v4.9.0 บริการพุชจึงสามารถเปิดเผยได้แม้ว่าแอปจะถูกเปิดใช้งาน iOS รองรับตั้งแต่ iOS 10

คลาสการตั้งค่าการผลักดัน

คลาสต่อไปนี้แสดงให้เห็นว่าข้อความพุชถูกส่งหรือไม่เมื่อแอปถูกเปิดใช้งาน

การตั้งค่าการส่งกลับ

เรียกใช้ callback ต่อไปนี้เมื่อเรียกใช้ API การตั้งค่าการผลักดันเพื่อดึงข้อมูลเกี่ยวกับผลลัพธ์ของคำขอ

ตั้งค่าการรับข้อความพุชในแอปที่เปิดใช้งาน

ใช้ API ต่อไปนี้ คุณสามารถตั้งค่าการรับข้อความพุชเมื่อแอปถูกเปิดใช้งาน

using hive;    
    // การตั้งค่าการส่งข้อมูลระยะไกล    
    Boolean useForegroundRemotePush = true;    
    // การตั้งค่าการส่งข้อมูลในท้องถิ่น    
    Boolean useForegroundLocalPush = false;    
    PushSetting pushSetting = new PushSetting(useForegroundRemotePush, useForegroundLocalPush);    
    Push.setForegroundPush (pushSetting, (ResultAPI result, PushSetting setting) => {    
         if (result.isSuccess()) {    
    // การเรียกสำเร็จ    
    // การตั้งค่า: ผลลัพธ์ของการแสดงการแจ้งเตือนที่ตั้งค่าผ่าน API    
         }    
});

#include "HivePush.h"

// การตั้งค่าการส่งข้อมูลระยะไกล 
bool bUseForegroundRemotePush = true;
// การตั้งค่าการส่งข้อมูลในเครื่อง   
bool bUseForegroundLocalPush = false;
FHivePushSetting PushSetting(bUseForegroundRemotePush, bUseForegroundLocalPush);
FHivePush::SetForegroundPush(PushSetting, FHivePushOnPushSettingDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHivePushSetting& PushSetting) {
        if (Result.IsSuccess()) {
            // เรียกใช้เมื่อสำเร็จ    
    // การตั้งค่า: ผลลัพธ์ของการแสดงการแจ้งเตือนที่ตั้งค่าผ่าน API 
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    // การตั้งค่าการส่งข้อมูลระยะไกล    
    bool useForegroundRemotePush = true;    
    // การตั้งค่าการส่งข้อมูลภายใน    
    bool useForegroundLocalPush = false;    

    PushSetting pushSetting(useRemote, useLocal);    

    Push::setForegroundPush(pushSetting, [=](ResultAPI const & result, PushSetting setting) {    
         if (result.isSuccess()) {    
             // call successful    
    // setting: Result of whether to display notifications set via API    
         }    
});

import com.hive.Push    
    import com.hive.ResultAPI    
    // การตั้งค่าการส่งพุชระยะไกล    
    val useForegroundRemotePush = true    
    // การตั้งค่าการส่งพุชในท้องถิ่น    
    val useForegroundLocalPush = false    
    val pushSetting = Push.PushSetting(useForegroundRemotePush, useForegroundLocalPush)    
    Push.setForegroundPush(pushSetting, object: Push.PushSettingListener{    
         override fun onPushSetting(result: ResultAPI, pushSetting: Push.PushSetting?) {    
             if (result.isSuccess) {    
                 // การเรียกสำเร็จ    
                 // pushSetting: ผลลัพธ์ของการตั้งค่าการมองเห็นการแจ้งเตือนที่ตั้งค่าผ่าน API    
             }    
         }    
})

import com.hive.Push;    
    import com.hive.ResultAPI;    
    // การตั้งค่าการส่งข้อมูลระยะไกล    
    boolean useForegroundRemotePush = true;    
    // การตั้งค่าการส่งข้อมูลในท้องถิ่น    
    boolean useForegroundLocalPush = false;    
    Push.PushSetting setting = new Push.PushSetting(useForegroundRemotePush, useForegroundLocalPush);    
    Push.INSTANCE.setForegroundPush(setting, (result, pushSetting) -> {    
         if (result.isSuccess()) {    
             // การเรียกสำเร็จ    
             // pushSetting: ผลลัพธ์ของการตั้งค่าการมองเห็นการแจ้งเตือนที่ตั้งค่าผ่าน API    
         }    
});

import HIVEService    
    let pushSetting = PushSetting()    
    // Remote push settings    
    pushSetting.useForegroundRemotePush = true    
    // Local push settings    
    pushSetting.useForegroundLocalPush = false    
    PushInterface.setForegroundPush(pushSetting) { result, setting in    
    if result.isSuccess() {    
    // call successful    
    // setting: Result of whether to display notifications set via API    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
    HIVEPushSetting *pushSetting = [[HIVEPushSetting alloc] init];    
    // การตั้งค่าการแจ้งเตือนระยะไกล    
    pushSetting.useForegroundRemotePush = YES;    
    // การตั้งค่าการแจ้งเตือนในท้องถิ่น    
    pushSetting.useForegroundLocalPush = NO;    

    [HIVEPush setForegroundPush: pushSetting handler: ^(HIVEResultAPI *result, HIVEPushSetting *setting) {    
         if ([result isSuccess]) {    
    // call successful    
    // setting: Result of whether to display notifications set via API    
         }    
}];

ค้นหาว่าการรับข้อความดันบนแอปที่เปิดใช้งาน

ใช้ API ต่อไปนี้ คุณสามารถค้นหาสถานะว่ามีการรับข้อความพุชเมื่อแอปถูกเปิดใช้งานหรือไม่

using hive;    
    Push.getForegroundPush ((ResultAPI result, PushSetting pushSetting) => {    
    if (result.isSuccess()) {    
    // TODO: Check whether notifications are received using pushSetting    
         }    
});

#include "HivePush.h"

FHivePush::GetForegroundPush(FHivePushOnPushSettingDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHivePushSetting& PushSetting) {
        if (Result.IsSuccess()) {
                // Check whether notifications are received using pushSetting
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Push::getForegroundPush([=](ResultAPI const & result, PushSetting pushSetting) {    
         if (result.isSuccess()) {    
    // TODO: Check whether notifications are received using pushSetting    
         }    
});

import com.hive.Push    
    import com.hive.ResultAPI    
    Push.getForegroundPush(object : Push.PushSettingListener {    
         override fun onPushSetting(result: ResultAPI, pushSetting: Push.PushSetting?) {    
             if (result.isSuccess) {    
                 // TODO: ตรวจสอบว่าควรได้รับการแจ้งเตือนด้วย pushSetting หรือไม่    
             }    
         }    
})

import com.hive.Push;    
    import com.hive.ResultAPI;    
    Push.INSTANCE.getForegroundPush((result, pushSetting) -> {    
         if (result.isSuccess()) {    
             //TODO: Check whether notifications are received using pushSetting    
         }    
});

import HIVEService    
    PushInterface.getForegroundPush() { result, pushSetting in    
    if result.isSuccess() {    
    // TODO: Check whether notifications are received using pushSetting    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPush getForegroundPush: ^(HIVEResultAPI *result, HIVEPushSetting *pushSetting) {    
         if ([result isSuccess]) {    
             // TODO: Check whether notifications are received using pushSetting    
         }    
}];

การอนุญาตชั่วคราว¶

Hive SDK v4.11.4 เริ่มสนับสนุนฟังก์ชันใหม่สำหรับ iOS 12, Provisional Authorization.

เนื่องจากหน้าต่างข้อตกลงในการส่งการแจ้งเตือนแบบพุชไม่ได้แสดงอีกต่อไปหลังจากที่มีการตกลงในข้อกำหนดการให้บริการของ Hive SDK ผู้ใช้ที่เรียกใช้แอปของคุณจะได้รับข้อความพุชทุกประเภทโดยอัตโนมัติ ด้วยการอนุญาตชั่วคราว ผู้ใช้ทุกคนสามารถเลือกที่จะรับการแจ้งเตือนแบบพุชในข้อความพุชหรือการตั้งค่าแอป การตั้งค่าเริ่มต้นคือข้อความพุชจะไม่มีเสียงหรือแสดงผลจนกว่าผู้ใช้จะเลือกเข้าร่วมในการแจ้งเตือนแบบพุชด้วยตนเองแม้ว่าผู้ใช้จะได้รับข้อความก็ตาม อุปกรณ์ที่ใช้ iOS เวอร์ชันก่อนหน้า 12 จะแสดงหน้าต่างข้อตกลงในการส่งการแจ้งเตือนแบบพุชหลังจากการเริ่มต้น Hive SDK ตามปกติ

ขออนุญาตการแจ้งเตือนที่เด่นชัด¶

จาก Hive SDK v4.16.2 (Android) คุณสามารถแสดงป๊อปอัพข้อตกลงเมื่อส่งการแจ้งเตือนแบบเด่นหากจำเป็นในเกม เพื่อแสดงป๊อปอัพข้อตกลงเมื่อส่งการแจ้งเตือนแบบเด่น ให้เรียกใช้วิธีการ requestPushPermission() ในคลาส Push ก่อนที่ผู้ใช้จะตั้งค่าการยินยอมในการส่งการแจ้งเตือนแบบเด่น สำหรับ iOS แม้ว่าผู้ใช้จะยินยอมตามข้อกำหนดในการให้บริการของ Hive SDK ผ่านการอนุญาตชั่วคราว ป๊อปอัพข้อตกลงเมื่อส่งการแจ้งเตือนแบบเด่นจะถูกแสดง และผู้ใช้สามารถรับการแจ้งเตือนแบบเด่นได้ สำหรับ Android ป๊อปอัพจะแสดงเมื่อ SDK เป้าหมายเป็น 33 หรือสูงกว่าในอุปกรณ์ Android 13 หรือสูงกว่า และเมื่อ SDK เป้าหมายต่ำกว่า 33 จะถูกแสดงเมื่อเรียกใช้ AuthV4.setup()

ต่อไปนี้คือตัวอย่างโค้ดเพื่อแสดงป๊อปอัปข้อตกลงเมื่อส่งการแจ้งเตือนแบบพุช

using hive;    
Push.requestPushPermission();

#include "HivePush.h"

FHivePush::RequestPushPermission();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
Push::requestPushPermission();

import com.hive.Push    
Push.requestPushPermission()

import com.hive.Push;    
Push.INSTANCE.requestPushPermission();

import HIVEService    
PushInterface.requestPushPermission()

#import <HIVEService/HIVEService-Swift.h>    
[HIVEPush requestPushPermission];

ตั้งค่าหลายภาษา¶

การแจ้งเตือนแบบพุชและไอคอนแอปแบดจ์¶

หากคุณได้รับการแจ้งเตือนบนอุปกรณ์ของคุณ ไอคอนแอปจะมีการแสดงป้ายโดยอัตโนมัติ ป้ายไอคอนแอปเป็นตัวนับที่แสดงจำนวนการแจ้งเตือนที่ได้รับสำหรับแอปในมุมขวาบนของไอคอนแอป ฟีเจอร์ป้ายนี้สามารถเปิด/ปิดได้ในการตั้งค่าอุปกรณ์หรือการกำหนดค่าแอป โดยค่าเริ่มต้น การแสดงป้ายจะปฏิบัติตามนโยบายด้านล่างตามระบบปฏิบัติการ

• iOS
  • ไอคอนแอปจะมีหมายเลข 1 เสมอไม่ว่าจะมีการแจ้งเตือนใหม่เข้ามากี่รายการก็ตาม
  • เมื่อไอคอนแอปกลายเป็น 0 การแจ้งเตือนทั้งหมดที่สะสมอยู่ในศูนย์การแจ้งเตือนจะถูกลบออก
  • เวลาที่ไอคอนแอปกลายเป็น 0 ด้วย Hive SDK จะอธิบายไว้ด้านล่าง
    • การรันครั้งแรกของแอป
    • เมื่อแอปกลับมาที่พื้นหลังโดยการคลิกที่การแจ้งเตือนหนึ่งรายการ
• Android
  • ไอคอนแอปจะเพิ่มขึ้น 1 เมื่อมีการแจ้งเตือนใหม่เข้ามา
  • เมื่อแอปกลับมาที่พื้นหลังโดยการคลิกที่การแจ้งเตือนหนึ่งรายการเพื่อรันแอปหรือด้วยวิธีอื่น ๆ ไอคอนจะถูกรีเซ็ตเป็น 0
  • การแจ้งเตือนที่ถูกคลิกเท่านั้นที่จะถูกลบออกจากศูนย์การแจ้งเตือน