Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Fix] Changelog and migration guide to include push to start live activities feature #749

Merged
merged 2 commits into from
Aug 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
1 change: 1 addition & 0 deletions OneSignalExample/Assets/OneSignal/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [5.1.7]
### Changed
- Updated SDK to support Live Activities PushToStart and added a concept of a "Default" Live Activity to facilitate easier adoption. Please check out https://documentation.onesignal.com/docs/push-to-start-live-activities for more information and our [example app](https://github.com/OneSignal/OneSignal-Unity-SDK/tree/main/OneSignalExample) for an example implementation.
- Updated included Android SDK from 5.1.13 to [5.1.17](https://github.com/OneSignal/OneSignal-Android-SDK/releases/tag/5.1.17)
- Fixed Xiaomi notification click not foregrounding app
- Fixed FCM push token not being refreshed
Expand Down
Loading