Unity
基于Unity的移动应用跨平台SDK指南。
React Native 和 Expo
React Native和Expo环境的设置说明。
Flutter
使用Dart的Flutter应用SDK指南。
Ionic 和 Ionic Capacitor
Ionic和Capacitor混合移动应用的设置。
.NET MAUI
与.NET MAUI应用集成的指南。
华为Android原生
使用HMS推送服务的华为设备SDK设置。
选择并按**Next**。
通过提供名称（示例：`OneSignalWidget`）配置Widget扩展，并确保选择**Include Live Activity**。然后点击**Finish**。
如果提示激活方案，点击**Don't Activate**。
打开您的`Podfile`并添加以下代码。将`OneSignalWidgetExtension`替换为您的widget扩展目标名称。
```ruby Podfile theme={null}
target 'OneSignalWidgetExtension' do
#use_frameworks!
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
关闭Xcode并运行`pod repo update && pod install`以安装`OneSignalLiveActivities` pod。
使用以下默认实时活动布局更新\_WidgetExtensionLiveActivity.swift\_的内容。此Widget中的值可以更改为您希望在widget上显示的任何内容，setupDefault方法将处理为这些属性定义结构。
```swift Swift theme={null}
import ActivityKit
import WidgetKit
import SwiftUI
import OneSignalLiveActivities
// 您的结构名称在这里可能不同
@available(iOS 16.2, *)
struct OneSignalWidgetLiveActivity: Widget {
var body: some WidgetConfiguration {
ActivityConfiguration(for: DefaultLiveActivityAttributes.self) { context in
// 锁屏/横幅UI
VStack {
Spacer()
Text("标题: " + (context.attributes.data["title"]?.asString() ?? ""))
.font(.headline)
Spacer()
HStack {
Spacer()
Text(context.state.data["message"]?.asDict()?["en"]?.asString() ?? "默认消息")
Spacer()
}
Text("INT: " + String(context.state.data["intValue"]?.asInt() ?? 0))
Text("DBL: " + String(context.state.data["doubleValue"]?.asDouble() ?? 0.0))
Text("BOL: " + String(context.state.data["boolValue"]?.asBool() ?? false))
Spacer()
}
.activitySystemActionForegroundColor(.black)
.activityBackgroundTint(.white)
} dynamicIsland: { _ in
DynamicIsland {
// 扩展UI
DynamicIslandExpandedRegion(.leading) {
Text("前导")
}
DynamicIslandExpandedRegion(.trailing) {
Text("尾随")
}
DynamicIslandExpandedRegion(.bottom) {
Text("底部")
// 更多内容
}
} compactLeading: {
Text("L")
} compactTrailing: {
Text("T")
} minimal: {
Text("最小")
}
.widgetURL(URL(string: "http://www.apple.com"))
.keylineTint(Color.red)
}
}
}
```
***
## 测试实时活动
1. 启动应用
2. 查看我们[启动实时活动API参考](/reference/start-live-activity)中的所有可能字段。这些字段的结构可能因您设置UI的方式而有所不同。例如：
* `"event_updates"`：这是实时活动启动后可以更新的动态数据（代码示例中`context.state`之后的任何内容）。由于我们有context.state.data，我们会向此字段添加数据对象以及我们在代码示例中添加的消息字典等任何其他字段。使用方法请参见下面的示例请求。
* `"event_attributes"`：这是在推送启动请求中设置的静态数据，在实时活动被移除或覆盖之前保持相同的值。
3. 使用推送启动时，您在请求中设置`"activity_id"`，而不是在代码中。使用不同的活动ID将启动新的实时活动。使用相同的活动ID将覆盖当前使用该ID的widget。
4. 确保您已更改URL路径中的[OneSignal应用ID](./keys-and-ids)和Authorization头中的[Rest API密钥](./keys-and-ids#rest-api-key)。如果您使用默认设置，则无法更改`DefaultActivityAttributes`类型。另请注意，添加到路径的活动类型区分大小写，应与您定义的内容或下面示例中使用的默认活动匹配。
```curl curl theme={null}
curl --request POST \
--url https://api.onesignal.com/apps/YOUR_APP_ID/activities/activity/DefaultLiveActivityAttributes \
--header 'Authorization: key YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--data '
{
"event": "start",
"event_updates": {
"data": {
"message": {
"en": "消息嵌套在context.state.data[\"message\"]中作为字典"
},
"intValue": 10,
"doubleValue": 3.14,
"boolValue": true
}
},
"event_attributes": {
"data": {
"title": "这在LA启动时设置，之后不会更新"
}
},
"activity_id": "my-activity-id",
"name": "OneSignal通知名称",
"contents": {
"en": "英文消息"
},
"headings": {
"en": "英文消息"
},
"sound": "beep.wav",
"priority": 10
}'
```
***
## 低级方法
如果您想生成自己的推送启动令牌，这些是可选方法，这也已在SDK的最新版本中添加。使用这些方法需要您与Xcode进行更多交互，并使用Swift为推送启动生成自己的令牌。您可以在[这里](https://github.com/OneSignal/OneSignal-iOS-SDK/pull/1377#:~:text=Alternative%20\(low%20level\)%20method%20to%20setup%20Live%20Activities%20with%20OneSignal)找到相关指南。