Unity
Unity tabanlı mobil uygulamalar için platformlar arası SDK rehberi.
React Native & Expo
React Native ve Expo ortamları için kurulum talimatları.
Flutter
Dart kullanan Flutter uygulamaları için SDK rehberi.
Ionic & Ionic Capacitor
Ionic ve Capacitor hibrit mobil uygulamalar için kurulum.
.NET MAUI
.NET MAUI uygulamalarıyla entegrasyon için rehber.
Huawei Android Native
HMS push servislerini kullanan Huawei cihazlar için SDK kurulumu.
Seçin ve **Next** düğmesine basın.
Bir isim vererek Widget Extension'ı yapılandırın (örnek: `OneSignalWidget`) ve **Include Live Activity** seçeneğinin seçildiğinden emin olun. Ardından **Finish** düğmesine tıklayın.
Şemayı etkinleştirmeniz istenirse **Don't Activate** düğmesine tıklayın.
`Podfile` dosyanızı açın ve aşağıdaki kodu ekleyin. `OneSignalWidgetExtension` yerine widget extension hedefinizin adını yazın.
```ruby Podfile theme={null}
target 'OneSignalWidgetExtension' do
#use_frameworks!
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
Xcode'u kapatın ve `OneSignalLiveActivities` pod'unu yüklemek için `pod repo update && pod install` komutunu çalıştırın.
*WidgetExtensionLiveActivity.swift* dosyasının içeriğini aşağıdaki varsayılan Live Activity düzeniyle güncelleyin. Bu Widget'taki değerler, widget'ta görüntülenmesini istediğiniz herhangi bir şeye değiştirilebilir, setupDefault metodu bu öznitelikler için struct tanımlamayı halledecektir.
```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'yi test edin
1. Uygulamayı başlatın
2. [Start Live Activity API referansımızda](/reference/start-live-activity) olası tüm alanları görün. Bu alanların yapısı, UI'nizi nasıl kurduğunuza bağlı olarak farklılık gösterebilir. Örneğin:
* `"event_updates"`: Bu, Live Activity başlatıldıktan sonra güncellenebilecek dinamik veridir (kod örneğindeki `context.state` sonrasındaki her şey). context.state.data olduğundan, bu alana bir data nesnesi ve kod örneğinde eklediğimiz mesaj sözlüğü gibi içindeki ek alanları ekleriz. Kullanım için aşağıdaki örnek isteğe bakın.
* `"event_attributes"`: Bu, push to start isteğinde ayarlanan ve Live Activity kaldırılana veya üzerine yazılana kadar aynı değeri koruyan statik veridir.
3. Push to start kullanırken, `"activity_id"` kodda değil istekte ayarlanır. Farklı Activity ID'leri kullanmak yeni Live Activity'ler başlatacaktır. Aynı Activity ID'yi kullanmak, o ID'yi şu anda kullanan widget'ın üzerine yazacaktır.
4. URL yolunuzda [OneSignal App ID](./keys-and-ids)'yi ve Authorization başlığında [Rest API Key](./keys-and-ids#rest-api-key)'i değiştirdiğinizden emin olun. Varsayılan kurulumu kullanıyorsanız `DefaultActivityAttributes` türü değiştirilemez. Ayrıca lütfen yolunuza eklenen activity türünün büyük/küçük harfe duyarlı olduğunu ve sizin tanımladığınız veya aşağıdaki örnekte kullanılan Varsayılan activity ile eşleşmesi gerektiğini unutmayın.
```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
}'
```
***
## Düşük seviye metodlar
Bunlar, SDK'nın en son sürümünde de eklenmiş olan kendi Push To Start token'ınızı oluşturmak istiyorsanız kullanabileceğiniz isteğe bağlı metodlardır. Bu metodları kullanmak, Xcode ile daha fazla etkileşim kurmanızı ve Swift ile Push To Start için kendi token'ınızı oluşturmanızı gerektirir. Bu konuda bir rehberi [burada](https://github.com/OneSignal/OneSignal-iOS-SDK/pull/1377#:~:text=Alternative%20\(low%20level\)%20method%20to%20setup%20Live%20Activities%20with%20OneSignal) bulabilirsiniz.