Skip to content

Commit

Permalink
Add push to start live activity documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
shepherd-l committed Jul 29, 2024
1 parent 279161e commit 7d0d404
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions MIGRATION_GUIDE_v3_to_v5.md
Original file line number Diff line number Diff line change
Expand Up @@ -262,6 +262,10 @@ The Live Activities namespace is accessible via `OneSignal.LiveActivities` and p
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Task<bool> EnterAsync(string activityId, string token)` | ***Note:*** *This method is for iOS only<br>Entering a Live Activity associates an activityId with a live activity temporary push token on OneSignal's server. The activityId is then used with the OneSignal REST API to update one or multiple Live Activities at one time.* |
| `Task<bool> ExitAsync(string activityId)` | ***Note:*** *This method is for iOS only<br>Exiting a Live activity deletes the association between a customer defined activityId with a Live Activity temporary push token on OneSignal's server.* |
| `void SetupDefault(LiveActivitySetupOptions options = null)` | ***Note:*** *This method is for iOS only<br>Enable the OneSignalSDK to setup the default`DefaultLiveActivityAttributes` structure, which conforms to the `OneSignalLiveActivityAttributes`. When using this function, the widget attributes are owned by the OneSignal SDK, which will allow the SDK to handle the entire lifecycle of the live activity. All that is needed from an app-perspective is to create a Live Activity widget in a widget extension, with a `ActivityConfiguration` for `DefaultLiveActivityAttributes`. This is most useful for users that (1) only have one Live Activity widget and (2) are using a cross-platform framework and do not want to create the cross-platform <-> iOS native bindings to manage ActivityKit.* |
| `void StartDefault(string activityId, IDictionary<string, object> attributes, IDictionary<string, object> content)` | ***Note:*** *This method is for iOS only<br>Start a new LiveActivity that is modelled by the default `DefaultLiveActivityAttributes` structure. The `DefaultLiveActivityAttributes` is initialized with the dynamic `attributes` and `content` passed in.* |
| `void SetPushToStartToken(string activityType, string token)` | ***Note:*** *This method is for iOS only<br>Indicate this device is capable of receiving pushToStart live activities for the `activityType`. The `activityType` **must** be the name of the struct conforming to `ActivityAttributes` that will be used to start the live activity.* |
| `void RemovePushToStartToken(string activityType)` | ***Note:*** *This method is for iOS only<br>Indicate this device is no longer capable of receiving pushToStart live activities for the `activityType`. The `activityType` **must** be the name of the struct conforming to `ActivityAttributes` that will be used to start the live activity.* |


### Debug Namespace
Expand Down

0 comments on commit 7d0d404

Please sign in to comment.