HIVE provides a function that can be used as a game alarm by registering a push notification to a device from a game client without HIVE push server. This is called Local Push. HIVE provides local push registration and release functions. The registered local push will notify you at the specified time even if you close your app, and the registered local push can be unregistered as needed.

Local Push Data

HIVE defines Local Push data in LocalPush class with the following contents.

Name Type Description
noticeId Integer Identifier of Local Push message
title String Title of Local Push message
msg String Contents of Local Push message
after Integer Interval between push registration and message popup (unit: second, default=0)
groupId String This is the group ID for notification group. The notification group displays the notifications sent from the same app in a group on a user’s device. If you didn’t set a value for this, the local push messages would be displayed in the default app group.

Registering Local Push

To register Local Push Notification on user devices, call registerLocalPush() method of Push class.

On iOS, the maximum count of Local Push Notification for registration is 64, and it may limit up to less than 64 according to the version of the device and OS. If you register notifications over the limitation, it discards the oldest notification in order. (Link)

Followings are sample codes to register Local Push.


API Reference: hive.Push.registerLocalPush


API Reference: Push::registerLocalPush


API Reference: registerLocalPush


API Reference: com.hive.Push.registerLocalPush


API Reference: registerLocalPush(_:handler:)


API Reference: Objective-C

Unregistering Local Push

You can unregister the registered local push notification before the specified notification time.

Unregister the Registered Local Push
Using the following APIs, set the registered push identifier as parameter (noticeId), and unregister the local push.


API Reference: hive .Push.unregisterLocalPush


API Reference: Push ::unregisterLocalPush


API Reference: Push.unregisterLocalPush


API Reference: com .hive.Push.unregisterLocalPush


API Reference: PushInterface .unregisterLocalPush


API Reference: HIVEPush ::unregisterLocalPush

Unregister the Listed Local Pushes at once
Using the following APIs, you can create the list of registered local push identifier, and unregister the local push at once.


API Reference: hive.Push .unregisterLocalPushes


API Reference: Push:: unregisterLocalPushes


API Reference: Push.unregisterLocalPushes


API Reference: com.hive .Push.unregisterLocalPushes


API Reference: PushInterface .unregisterLocalPushes


API Reference: HIVEPush:: unregisterLocalPushes

Unregister all Local Pushes
Using the following APIs, you can unregister not only Hive’s local pushes but also all local pushes in listening state.


API Reference: hive.Push .unregisterAllLocalPushes


API Reference: Push:: unregisterAllLocalPushes


API Reference: Push.unregisterAllLocalPushes


API Reference: com.hive .Push.unregisterAllLocalPushes


API Reference: PushInterface.unregisterAllLocalPushes


API Reference: HIVEPush:: unregisterAllLocalPushes

Customizing Local Push UI (Android only)

Local Push can be customized on Android device. Information about the UI elements to be customized is set in the LocalPush class parameter of the registerLocalPush() method that registers the local push along with the push setting information.

Local Push UI

The customizing data of Local Push UI is defined in the LocalPush class, which defines the data of Local Push Settings. Following table describes some changeable fields from LocalPush class relevant to UI items.
Some field names are linked with details. Click the field name to read more details with screen shot.

Name Type Description Required
type String Dialogue type of Push message:

  • "bar": Display on notification bar only
  • "popup": Display popups only
  • "bar, popup": Display both notification bar and popups
bigmsg String Contents which users peek from the top of the screen. Unlimited length
Caution: Available with Android Jelly Bean (4.1) and higher
ticker String Tickers with push notifications Optional
icon String The file name in /res/drawable directory , excluding file extension.
e.g. If the file path is res/drawable-xhdpi/hive_icon.png, the value of icon field is "hive_icon".
Without file name, game icon is displayed as default
sound String File path for sound file alarming push notifications
Without file path, default notification sound
active String Action settings when users tap a push notification:

  • "app": Execute the game (default)
  • "web:< URL to move>": Move to the URL
broadcastAction String Action value to broadcast Optional
buckettype Integer Type to display push notifications:

  • 0: Overwrite (default)
  • 1: Inboxing
  • 2: Append
bucketsize Integer The number of messages related to one push ID to show at once Optional
bigpicture String File path for image file displaying on push notifications

Optional /td>
icon_color String Background color of icon
Format: {"r":[0–255],"g":[0–255],"b":[0–255]}
e.g.: {"r":0,"g":128,"b":255}
Caution: Available with Android Lollipop (5.0) and higher
type Field

type field means the dialog form of the push message. This form defines how to display push messages on the screen.

The dialogue form of push message has three options.

  • Bar type: Bar is displayed on the top of the screen with icon, title, and message. Notification is not displayed when a device screen is off.
  • Popup Type: Popup is displayed like toast format
  • Both Bar and Popup Type: Both bar and popup are displayed on the screen

If a device screen is off and the type is set to Both Bar and Popup Type, popup is displayed only as image above.

bigmsg and bigpicture Field

See the image below to check big message and big picture displayed on the screen.

  • Use bigmsg field to display a bunch of text. ticker field is available with bigmsg.
  • With bigpicture field, you can display a big-size picture on the notification screen.
  • bigpicture is unavailable with bigmsg.
  • bigpicture is available with ticker.
buckettype Field

If several notifications are shown up and the value of buckettype field is 1 or 2, the stacked notifications are displayed on a section.

  • bucketsize means the number of messages exposed on the notification bar.
  • If the value of buckettype is 1, which means Inboxing type, and If the message exceeds one line, an ellipsis (…) is added, and the contents beyond the screen are not displayed.
  • If the value of buckettype is 2, the whole text is displayed on the screen.
  • buckettype is available with ticker.

Send Facebook Cloud Game Notification (Android)

With the Hive SDK‘s local push feature provided from the Facebook Cloud Game build, you can use Facebook App To User Notifications.
For the Facebook notification, there are limitations which are different from the ordinary pushes of Android. Please check the details on the Facebook App To User Notifications page.

Note that the Facebook notifications features are constantly being updated by Facebook, causing constant changes in its behavior. Until the Facebook notification feature becomes stable, the Hive SDK will be continuously updated.
(Hive v4.16.1 has followed up and verified the Facebook App To User Notifications update as of October 2022.) The data required for the the Facebook notification feature must be defined in the LocalPush class. The following table defines which of the fields of the LocalPush class are required for the Facebook notifications.

title String – Local push message title– 1~30 characters are required– The title value is required as of Hive 4.16.1, but it is not confirmed where it is used in the Facebook UI. required
msg String – Local push message content– 10~180 characters are required– Exposed as a message in the notification required
after Integer – Indicates how many seconds it will take after push registrationto display a push message (in seconds, default value = 0)– Set the time value (seconds) up to 10 days or less required
bigpicture String – Image setting required– 300×200 px– less than 10MB– If the image is posted as a web link, the url starting with http or https(ex:– If the image file is included in project resources, the image file should be included under /res/drawable. If the file name is fbcloudtest.png, only fbcloudtest is entered as a value. required

When a notification arrives, the content of the notification is displayed on the Facebook web page and app as shown below.

  • Being exposed in the center of the Gaming page
  • Being found on the Notifications menu, toggled from the left list of the Gaming page
  • Being exposed on the Facebook App