beamable-sdk / services / AnnouncementsService
Class: AnnouncementsService¶
Defined in: src/services/AnnouncementsService.ts:19
Represents a service that can be refreshed.
Extends¶
Implements¶
Constructors¶
Constructor¶
new AnnouncementsService(
props):AnnouncementsService
Defined in: src/services/AnnouncementsService.ts:23
Parameters¶
props¶
Returns¶
AnnouncementsService
Overrides¶
ApiService.constructor
Methods¶
claim()¶
claim(
params):Promise<void>
Defined in: src/services/AnnouncementsService.ts:85
Claims one or more announcements for the current player.
Parameters¶
params¶
Returns¶
Promise<void>
Remarks¶
This marks the announcements as claimed, allowing the player to access any associated rewards.
Example¶
// client-side:
const announcements = beam.announcements;
// server-side:
const announcements = beamServer.announcements(playerId);
// claim a single announcement
await announcements.claim({ id: "id" });
// claim multiple announcements
await announcements.claim({ id: ["id-1", "id-2"] });
Throws¶
If the announcement ID is invalid or the operation fails.
delete()¶
delete(
params):Promise<void>
Defined in: src/services/AnnouncementsService.ts:159
Deletes one or more announcements for the current player.
Parameters¶
params¶
Returns¶
Promise<void>
Remarks¶
Ensure any claimable announcements are handled appropriately before deletion.
Example¶
// client-side:
const announcements = beam.announcements;
// server-side:
const announcements = beamServer.announcements(playerId);
// delete a single announcement
await announcements.delete({ id: "id" });
// delete multiple announcements
await announcements.delete({ id: ["id-1", "id-2"] });
Throws¶
If the announcement ID is invalid or the operation fails.
list()¶
list():
Promise<AnnouncementView[]>
Defined in: src/services/AnnouncementsService.ts:56
Fetches all active announcements for the current player.
Returns¶
Promise<AnnouncementView[]>
Example¶
// client-side
const announcements = await beam.announcements.list();
// server-side
const announcements = await beamServer.announcements(playerId).list();
Throws¶
If the request fails.
markAsRead()¶
markAsRead(
params):Promise<void>
Defined in: src/services/AnnouncementsService.ts:122
Marks one or more announcements as read for the current player.
Parameters¶
params¶
Returns¶
Promise<void>
Example¶
// client-side:
const announcements = beam.announcements;
// server-side:
const announcements = beamServer.announcements(playerId);
// mark a single announcement as read
await announcements.markAsRead({ id: "id" });
// mark multiple announcements as read
await announcements.markAsRead({ id: ["id-1", "id-2"] });
Throws¶
If the announcement ID is invalid or the operation fails.
refresh()¶
refresh():
Promise<AnnouncementView[]>
Defined in: src/services/AnnouncementsService.ts:41
Refreshes the announcements for the current player.
Returns¶
Promise<AnnouncementView[]>
Remarks¶
This method fetches the latest announcements and updates the player's announcement list.
Example¶
Throws¶
If the refresh fails.