Stay organized with collections
Save and categorize content based on your preferences.
<GNSSubscription> Protocol Reference
Overview
A subscription object represents the act of subscribing to messages of a certain type from nearby devices.
As long as it lives, the messages library will do its best to deliver messages that match the subscription’s type, as long as the required conditions are met (e.g., the app must be in the foreground). Message handlers are called when messages are are discovered or lost. When the subscription object is deallocated, message delivery will cease.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-12 UTC."],[[["\u003cp\u003eThe GNSSubscription protocol enables subscribing to specific message types from nearby devices.\u003c/p\u003e\n"],["\u003cp\u003eActive subscriptions trigger message delivery to the app, primarily when it's in the foreground, based on defined criteria.\u003c/p\u003e\n"],["\u003cp\u003eMessage handlers manage the discovery and loss of messages, ensuring appropriate actions are taken.\u003c/p\u003e\n"],["\u003cp\u003eDeallocation of the subscription object halts further message delivery to the application.\u003c/p\u003e\n"]]],["A subscription object enables receiving specific message types from nearby devices. The messages library actively delivers matching messages while the subscription is active, under certain conditions (e.g., app foreground). Message handlers are triggered upon message discovery or loss. Deallocating the subscription object stops message delivery. It inherits from `NSObject`.\n"],null,["\\\u003cGNSSubscription\\\u003e Protocol Reference \n\nOverview \nA subscription object represents the act of subscribing to messages of a certain type from nearby devices.\n\nAs long as it lives, the messages library will do its best to deliver messages that match the subscription's type, as long as the required conditions are met (e.g., the app must be in the foreground). Message handlers are called when messages are are discovered or lost. When the subscription object is deallocated, message delivery will cease.\n\nInherits \\\u003cNSObject\\\u003e."]]