การส่งการแจ้งเตือนแบบท้องถิ่น

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

ข้อมูลการผลักดันในท้องถิ่น¶

HIVE กำหนดข้อมูล Local Push ในคลาส LocalPush ด้วยเนื้อหาดังต่อไปนี้

การลงทะเบียนการส่งข้อความท้องถิ่น¶

ในการลงทะเบียนการแจ้งเตือนแบบ Local Push บนอุปกรณ์ของผู้ใช้ ให้เรียกใช้วิธีการ registerLocalPush() ของคลาส Push

ต่อไปนี้คือตัวอย่างโค้ดสำหรับลงทะเบียน Local Push

using hive;    
    LocalPush localPush = new LocalPush ();    
    localPush.noticeId = 1;    
    localPush.title = "Local Push Title";    
    localPush.msg = "Local Push Message";    
    localPush.after = 5;    
    localPush.groupId = "a";    

    Push.registerLocalPush(localPush, (ResultAPI result, LocalPush localPush) => {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

#include "HivePush.h"

FHiveLocalPush LocalPush;
LocalPush.NoticeId = 1;
LocalPush.Title = TEXT("Local Push Title");
LocalPush.Msg = TEXT("Local Push Message");
LocalPush.After = 5;
LocalPush.GroupId = TEXT("a");

FHivePush::RegisterLocalPush(LocalPush, FHivePushOnLocalPushDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveLocalPush& LocalPush) {
        if (Result.IsSuccess()) {
                // API call successfull
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    LocalPush localPush;    
    localPush.noticeId = 1;    
    localPush.title = "Local Push Title";    
    localPush.msg = "Local Push Message";    
    localPush.after = 5;    
    localPush.groupId = "a";    

    Push::registerLocalPush(localPush, [=](ResultAPI result, LocalPush localPush){    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import com.hive.Push    
    import com.hive.ResultAPI    
    val localPush = Push.LocalPush().apply {    
         noticeID = 1    
         title = "Local Push Title"    
         msg = "Local Push Message"    
         after = 5    
         groupId = "a"    
    }    
    Push.registerLocalPush(localPush, object : Push.LocalPushListener {    
         override fun onRegisterLocalPush(result: ResultAPI, localPush: Push.LocalPush?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.Push;    
    import com.hive.ResultAPI;    
    Push.LocalPush localPush = new Push.LocalPush();    
    localPush.setNoticeID(1);    
    localPush.setTitle("Local Push Title");    
    localPush.setMsg("Local Push Message");    
    localPush.setAfter(5);    
    localPush.setGroupId("a");    
    Push.INSTANCE.registerLocalPush(localPush, (result, localPushData) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    let localPush = LocalPush()    
    localPush.noticeId = 1;    
    localPush.title = "Local Push Title";    
    localPush.msg = "Local Push Message";    
    localPush.after = 5;    
    localPush.groupId = "a";    
    PushInterface.registerLocalPush(localPush) { result, localPush in    
    if result.isSuccess() {    
    // call successful    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
    HIVELocalPush *localPush = [[HIVELocalPush alloc] init];    
    localPush.noticeId = 1;    
    localPush.title = @"Local Push Title";    
    localPush.msg = @"Local Push Message";    
    localPush.after = 5;    
    localPush.groupId = @"a";    

    [HIVEPush registerLocalPush: localPush handler: ^(HIVEResultAPI *result, HIVELocalPush *localPush) {    
         if ([result isSuccess]) {    
             // call successful    
         }    
}];

ยกเลิกการลงทะเบียนการแจ้งเตือนท้องถิ่น¶

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

ยกเลิกการลงทะเบียน Local Push ที่ลงทะเบียนไว้ ใช้ API ต่อไปนี้ ตั้งค่าตัวระบุการแจ้งเตือนที่ลงทะเบียนเป็นพารามิเตอร์ (noticeId) และยกเลิกการลงทะเบียน Local Push

using hive;    
    int noticeId = 1; // local push unique ID    
Push.unregisterLocalPush(noticeId);

#include "HivePush.h"

int32 NoticeID = 1; // local push unique ID 

FHivePush::UnregisterLocalPush(NoticeID);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    int noticeId = 1; // local push unique ID    
Push::unregisterLocalPush(noticeId);

import com.hive.Push    
    val noticeId = 1 // local push unique ID    
Push.unregisterLocalPush(noticeId)

import com.hive.Push;    
    int noticeId = 1; // local push unique ID    
Push.INSTANCE.unregisterLocalPush(noticeId);

import HIVEService    
    let noticeId = 1 // local push unique ID    
PushInterface.unregisterLocalPush(noticeId)

#import <HIVEService/HIVEService-Swift.h>    
    NSInteger noticeId = 0; // local push unique ID    
[HIVEPush unregisterLocalPush: noticeId];

ยกเลิกการลงทะเบียนการแจ้งเตือนท้องถิ่นที่ระบุทั้งหมด

โดยใช้ API ต่อไปนี้ คุณสามารถสร้างรายการของตัวระบุการผลักดันในท้องถิ่นที่ลงทะเบียน และยกเลิกการลงทะเบียนการผลักดันในท้องถิ่นทั้งหมดได้ในครั้งเดียว

using hive;    
    List noticeIds = new List { 1, 2, 3 }();    
Push.unregisterLocalPushes(noticeIds);

#include "HivePush.h"

TArray<int32> NoticeIds = { 1, 2, 3 };

FHivePush::UnregisterLocalPushes(NoticeIds);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    vector noticeIds = { 1, 2, 3 };    
Push::unregisterLocalPushes(noticeIds);

import com.hive.Push    
    val noticeIds = arrayListOf(1, 2, 3)    
Push.unregisterLocalPushes(noticeIds)

import com.hive.Push;    
    ArrayList<Integer> noticeIds = new ArrayList<>();    
    noticeIds.add(1);    
    noticeIds.add(2);    
    noticeIds.add(3);    
Push.INSTANCE.unregisterLocalPushes(noticeIds);

import HIVEService    
    let noticeIds = [1, 2, 3]    
PushInterface.unregisterLocalPushes(noticeids)

#import <HIVEService/HIVEService-Swift.h>    
    NSArray* noticeIds = @[ @(1), @(2), @(3) ];    
[HIVEPush unregisterLocalPushes: noticeIds];

ยกเลิกการส่งข้อความท้องถิ่นทั้งหมด

โดยใช้ API ต่อไปนี้ คุณสามารถยกเลิกการลงทะเบียนการแจ้งเตือนในท้องถิ่นของ Hive SDK ได้ไม่เพียงแต่ยังสามารถยกเลิกการแจ้งเตือนในท้องถิ่นทั้งหมดที่อยู่ในสถานะการฟัง

using hive;    
Push.unregisterAllLocalPushes();

#include "HivePush.h"

FHivePush::UnregisterAllLocalPushes();

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

import com.hive.Push    
Push.unregisterAllLocalPushes()

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

import HIVEService    
PushInterface.unregisterAllLocalPushes()

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

การปรับแต่ง UI การส่งข้อความในท้องถิ่น (เฉพาะ Android)¶

การแจ้งเตือนท้องถิ่นสามารถปรับแต่งได้บนอุปกรณ์ Android ข้อมูลเกี่ยวกับองค์ประกอบ UI ที่จะปรับแต่งถูกตั้งค่าในพารามิเตอร์ของคลาส LocalPush ของวิธีการ registerLocalPush() ที่ลงทะเบียนการแจ้งเตือนท้องถิ่นพร้อมกับข้อมูลการตั้งค่าการแจ้งเตือน

UI การผลักด локал¶

ข้อมูลการปรับแต่งของ Local Push UI ถูกกำหนดในคลาส LocalPush ซึ่งกำหนดข้อมูลของการตั้งค่า Local Push ตารางต่อไปนี้อธิบายฟิลด์ที่สามารถเปลี่ยนแปลงได้บางส่วนจากคลาส LocalPush ที่เกี่ยวข้องกับรายการ UI ชื่อฟิลด์บางชื่อเชื่อมโยงกับรายละเอียด คลิกที่ชื่อฟิลด์เพื่ออ่านรายละเอียดเพิ่มเติมพร้อมภาพหน้าจอ

type ฟิลด์¶

type ฟิลด์หมายถึงรูปแบบการสนทนาของข้อความที่ส่งไปยังผู้ใช้ รูปแบบนี้กำหนดวิธีการแสดงข้อความที่ส่งไปยังผู้ใช้บนหน้าจอ. รูปแบบการสนทนาของข้อความที่ส่งไปยังผู้ใช้มีสามตัวเลือก.

• ประเภทแถบ: แถบจะแสดงที่ด้านบนของหน้าจอพร้อมกับ ไอคอน, ชื่อเรื่อง, และ ข้อความ การแจ้งเตือนจะไม่แสดงเมื่อหน้าจอของอุปกรณ์ปิดอยู่
• ประเภทป๊อปอัพ: ป๊อปอัพจะแสดงในรูปแบบขนมปังปิ้ง
• ทั้งประเภทแถบและป๊อปอัพ: ทั้งแถบและป๊อปอัพจะแสดงบนหน้าจอ

หากหน้าจออุปกรณ์ปิดอยู่และประเภทถูกตั้งค่าเป็น ทั้งแบบบาร์และแบบป๊อปอัพ ป๊อปอัพจะแสดงเฉพาะเป็นภาพด้านบนเท่านั้น

bigmsg และ bigpicture ฟิลด์¶

ดูภาพด้านล่างเพื่อตรวจสอบข้อความใหญ่และภาพใหญ่ที่แสดงบนหน้าจอ。

• ใช้ฟิลด์ bigmsg เพื่อแสดงข้อความจำนวนมาก ฟิลด์ ticker ใช้งานได้กับ bigmsg。
• ด้วยฟิลด์ bigpicture คุณสามารถแสดงภาพขนาดใหญ่บนหน้าจอการแจ้งเตือน。
• bigpicture ไม่สามารถใช้ได้กับ bigmsg。
• bigpicture ใช้งานได้กับ ticker。

buckettype ฟิลด์¶

หากมีการแสดงการแจ้งเตือนหลายรายการและค่าของฟิลด์ buckettype เป็น 1 หรือ 2 การแจ้งเตือนแบบซ้อนจะถูกแสดงในส่วนหนึ่ง.

• bucketsize หมายถึงจำนวนข้อความที่แสดงบนแถบการแจ้งเตือน.
• หากค่าของ buckettype เป็น 1 ซึ่งหมายถึงประเภท Inboxing และหากข้อความเกินหนึ่งบรรทัด จะมีการเพิ่มจุดไข่ปลา (...) และเนื้อหาที่เกินจากหน้าจอจะไม่แสดง.
• หากค่าของ buckettype เป็น 2 ข้อความทั้งหมดจะแสดงบนหน้าจอ.
• buckettype ใช้งานได้กับ ticker.

ส่งการแจ้งเตือน Facebook cloud game (Android)¶

ด้วยฟีเจอร์การส่งข้อความในพื้นที่ของ Hive SDK ที่ให้บริการจากการสร้าง Facebook Cloud Game คุณสามารถใช้ Facebook App To User Notifications.

สำหรับการแจ้งเตือน Facebook มีข้อจำกัดที่แตกต่างจากการส่งข้อความปกติของ Android โปรดตรวจสอบรายละเอียดได้ที่ หน้า Facebook App To User Notifications

โปรดทราบว่าฟีเจอร์การแจ้งเตือนของ Facebook กำลังได้รับการอัปเดตอย่างต่อเนื่องโดย Facebook ทำให้เกิดการเปลี่ยนแปลงในพฤติกรรมอย่างต่อเนื่อง จนกว่าฟีเจอร์การแจ้งเตือนของ Facebook จะมีเสถียรภาพ Hive SDK จะได้รับการอัปเดตอย่างต่อเนื่อง (v4.16.1 ได้ติดตามและตรวจสอบการอัปเดตการแจ้งเตือนจาก Facebook App To User ตั้งแต่เดือนตุลาคม 2022.)

ข้อมูลที่จำเป็นสำหรับฟีเจอร์การแจ้งเตือน Facebook จะต้องถูกกำหนดในคลาส LocalPush ตารางต่อไปนี้กำหนดว่าฟิลด์ใดของคลาส LocalPush ที่จำเป็นสำหรับการแจ้งเตือน Facebook

เมื่อมีการแจ้งเตือนเข้ามา เนื้อหาของการแจ้งเตือนจะแสดงบนหน้าเว็บและแอป Facebook ดังที่แสดงด้านล่าง

การแสดงที่ศูนย์กลางของหน้าเกม<

การพบในเมนูการแจ้งเตือน ซึ่งเปิดจากรายการทางซ้ายของหน้าเกม

การแสดงบนแอป Facebook