Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gameball.co/llms.txt

Use this file to discover all available pages before exploring further.

Push Notifications

Gameball React Native SDK supports registering push tokens for Firebase and Huawei devices. Pass the token and provider when initializing the customer.

Register the Push Token

import { GameballApp, InitializeCustomerRequest, PushProvider } from 'react-native-gameball';

const request: InitializeCustomerRequest = {
  customerId: 'customer-123',
  email: 'john@example.com',
  deviceToken: firebaseToken,            // FCM token
  pushProvider: PushProvider.Firebase,   // or PushProvider.Huawei
};

await GameballApp.getInstance().initializeCustomer(request);
deviceToken and pushProvider must be provided together. If one is set, the other is required.

Handle Token Refresh

Push tokens can change. Re-register the updated token when your provider notifies you:
import messaging from '@react-native-firebase/messaging';
import { GameballApp, PushProvider } from 'react-native-gameball';

messaging().onTokenRefresh(async (token) => {
  await GameballApp.getInstance().initializeCustomer({
    customerId: 'customer-123',
    deviceToken: token,
    pushProvider: PushProvider.Firebase,
  });
});

Huawei Devices

import { GameballApp, PushProvider } from 'react-native-gameball';

await GameballApp.getInstance().initializeCustomer({
  customerId: 'customer-123',
  deviceToken: hmsToken,
  pushProvider: PushProvider.Huawei,
});
Call initializeCustomer after login/registration with the latest token to keep notifications working.