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**를 누르세요.
이름을 제공하여(예: `OneSignalWidget`) Widget Extension을 구성하고 **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의 값은 위젯에 표시하려는 모든 것으로 변경할 수 있으며 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가 있으므로 이 필드에 데이터 객체와 코드 예제에 추가한 message 딕셔너리와 같은 추가 필드를 추가합니다. 사용 방법은 아래 예제 요청을 참조하세요.
* `"event_attributes"`: push to start 요청에서 설정되는 정적 데이터이며 Live Activity가 제거되거나 덮어쓰기될 때까지 동일한 값을 유지합니다.
3. push to start를 사용할 때 코드가 아닌 요청에서 `"activity_id"`를 설정합니다. 다른 Activity ID를 사용하면 새 Live Activities가 시작됩니다. 동일한 Activity ID를 사용하면 현재 해당 ID를 사용하는 위젯을 덮어씁니다.
4. url 경로에서 [OneSignal 앱 ID](./keys-and-ids)를, Authorization 헤더에서 [Rest API Key](./keys-and-ids#rest-api-key)를 변경했는지 확인하세요. 기본 설정을 사용하는 경우 `DefaultActivityAttributes` 유형은 변경할 수 없습니다. 또한 경로에 추가된 activity 유형은 대소문자를 구분하며 아래 예제에서 사용된 기본 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": {
"data": {
"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
}'
```
***
## 하위 수준 메서드
SDK의 최신 릴리스에도 추가된 자체 Push To Start 토큰을 생성하려는 경우 사용할 수 있는 선택적 메서드입니다. 이러한 메서드를 사용하려면 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)에서 찾을 수 있습니다.