Unity
UnityベースのモバイルアプリのクロスプラットフォームSDKガイド。
React Native & Expo
React NativeおよびExpo環境のセットアップ手順。
Flutter
Dartを使用するFlutterアプリのSDKガイド。
Ionic & Ionic Capacitor
IonicおよびCapacitorハイブリッドモバイルアプリのセットアップ。
.NET MAUI
.NET MAUIアプリとの統合ガイド。
Huawei Android Native
HMSプッシュサービスを使用するHuaweiデバイスのSDKセットアップ。
選択して**Next**を押します。
名前を指定してWidget Extensionを構成し（例：`OneSignalWidget`）、**Include Live Activity**が選択されていることを確認します。次に、**Finish**をクリックします。
スキームのアクティブ化を求められたら、**Don't Activate**をクリックします。
`Podfile`を開き、次のコードを追加します。`OneSignalWidgetExtension`をwidget extensionターゲットの名前に置き換えます。
```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\_の内容を次のデフォルトのLive Activityレイアウトで更新します。このWidget内の値は、widgetに表示したいものに変更できます。setupDefaultメソッドは、これらの属性の構造体を定義します。
```swift Swift theme={null}
import ActivityKit
import WidgetKit
import SwiftUI
import OneSignalLiveActivities
// Your struct name might be different here
@available(iOS 16.2, *)
struct OneSignalWidgetLiveActivity: Widget {
var body: some WidgetConfiguration {
ActivityConfiguration(for: DefaultLiveActivityAttributes.self) { context in
// Lock screen / banner UI
VStack {
Spacer()
Text("Title: " + (context.attributes.data["title"]?.asString() ?? ""))
.font(.headline)
Spacer()
HStack {
Spacer()
Text(context.state.data["message"]?.asDict()?["en"]?.asString() ?? "Default Message")
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 {
// Expanded UI
DynamicIslandExpandedRegion(.leading) {
Text("Leading")
}
DynamicIslandExpandedRegion(.trailing) {
Text("Trailing")
}
DynamicIslandExpandedRegion(.bottom) {
Text("Bottom")
// More content
}
} compactLeading: {
Text("L")
} compactTrailing: {
Text("T")
} minimal: {
Text("Min")
}
.widgetURL(URL(string: "http://www.apple.com"))
.keylineTint(Color.red)
}
}
}
```
***
## Live Activityをテスト
1. アプリを起動します
2. [Start Live Activity APIリファレンス](/reference/start-live-activity)ですべての可能なフィールドを確認してください。これらのフィールドの構造は、UIの設定方法によって異なる場合があります。例：
* `"event_updates"`：これは、Live Activityが開始された後に更新できる動的データです（コード例の`context.state`以降のすべて）。context.state.dataがあるため、このフィールドにdataオブジェクトと、コード例で追加したメッセージ辞書などの追加フィールドを追加します。使用方法については、以下のリクエスト例を参照してください。
* `"event_attributes"`：これは、push to startリクエストで設定される静的データで、Live Activityが削除または上書きされるまで同じ値のままです。
3. push to startを使用する場合、コード内ではなく、リクエストで`"activity_id"`を設定します。異なるActivity IDを使用すると、新しいLive Activitiesが開始されます。同じActivity IDを使用すると、そのIDを現在使用しているwidgetが上書きされます。
4. URLパスで[OneSignal App ID](./keys-and-ids)を変更し、AuthorizationヘッダーでRest [API Key](./keys-and-ids#rest-api-key)を変更していることを確認してください。デフォルトのセットアップを使用している場合、`DefaultActivityAttributes`タイプは変更できません。また、パスに追加されるactivityタイプは大文字と小文字が区別され、ユーザーが定義したものまたは以下の例で使用されているDefault activityと一致する必要があることに注意してください。
```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": "The message is nested in context.state.data[\"message\"] as a dictionary"
},
"intValue": 10,
"doubleValue": 3.14,
"boolValue": true
}
},
"event_attributes": {
"title": "this is set when the LA starts and does not get updated after"
},
"activity_id": "my-activity-id",
"name": "OneSignal Notification Name",
"contents": {
"en": "English Message"
},
"headings": {
"en": "English Message"
},
"sound": "beep.wav",
"priority": 10
}'
```
***
## 低レベルメソッド
これらは、独自のPush To Startトークンを生成したい場合に使用するオプションのメソッドです。これは、SDKの最新リリースにも追加されています。これらのメソッドを使用するには、Xcodeとのやり取りを増やし、Swiftを使用してPush To Start用の独自のトークンを生成する必要があります。このガイドは[こちら](https://github.com/OneSignal/OneSignal-iOS-SDK/pull/1377#:~:text=Alternative%20\(low%20level\)%20method%20to%20setup%20Live%20Activities%20with%20OneSignal)で見つけることができます。