Unity
Guia de SDK multiplataforma para aplicativos móveis baseados em Unity.
React Native & Expo
Instruções de configuração para ambientes React Native e Expo.
Flutter
Guia de SDK para aplicativos Flutter usando Dart.
Ionic & Ionic Capacitor
Configuração para aplicativos móveis híbridos Ionic e Capacitor.
.NET MAUI
Guia para integração com aplicativos .NET MAUI.
Huawei Android Native
Configuração do SDK para dispositivos Huawei usando serviços push HMS.
Selecione e pressione **Next**.
Configure a Widget Extension fornecendo um nome (exemplo: `OneSignalWidget`) e certifique-se de que **Include Live Activity** esteja selecionado. Então clique em **Finish**.
Clique em **Don't Activate** se solicitado a ativar o scheme.
Abra seu `Podfile` e adicione o seguinte código. Substitua `OneSignalWidgetExtension` pelo nome do seu target de extensão de widget.
```ruby Podfile theme={null}
target 'OneSignalWidgetExtension' do
#use_frameworks!
pod 'OneSignalXCFramework', '>= 5.0.0', '< 6.0'
end
```
Feche o Xcode e execute `pod repo update && pod install` para instalar o pod `OneSignalLiveActivities`.
Atualize o conteúdo de *WidgetExtensionLiveActivity.swift* com o seguinte layout padrão de Live Activity. Os valores neste Widget podem ser alterados para o que você quiser exibido no widget, o método setupDefault cuidará de definir a struct para esses atributos.
```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)
}
}
}
```
***
## Testar a Live Activity
1. Iniciar o aplicativo
2. Veja todos os campos possíveis na nossa [referência da API Start Live Activity](/reference/start-live-activity). A estrutura desses campos pode diferir dependendo de como você configurou sua UI. Por exemplo:
* `"event_updates"`: Estes são os dados dinâmicos que podem ser atualizados após a Live Activity ter sido iniciada (qualquer coisa após `context.state` no exemplo de código). Como temos context.state.data, adicionaríamos um objeto data a este campo e quaisquer campos adicionais dentro como o dicionário de mensagem que adicionamos no exemplo de código. Para uso, veja exemplo de solicitação abaixo.
* `"event_attributes"`: Estes são os dados estáticos que são definidos na solicitação push to start e permanecem com o mesmo valor até que a Live Activity seja removida ou sobrescrita.
3. Ao usar push to start, você define o `"activity_id"` na solicitação, em vez de no código. Usar IDs de Activity diferentes iniciará novas Live Activities. Usar o mesmo Activity ID sobrescreverá o widget que está usando esse ID atualmente.
4. Certifique-se de que você alterou o [OneSignal App ID](./keys-and-ids) no caminho da sua url e a [Rest API Key](./keys-and-ids#rest-api-key) no cabeçalho de Authorization. O tipo `DefaultActivityAttributes` não pode ser alterado se você estiver usando a configuração padrão. Observe também que o tipo de atividade adicionado ao seu caminho diferencia maiúsculas de minúsculas e deve corresponder ao que está definido por você ou à atividade Default usada no exemplo abaixo.
```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
}'
```
***
## Métodos de baixo nível
Estes são métodos opcionais para usar se você quiser gerar seu próprio token Push To Start, que também foi adicionado na versão mais recente do SDK. Usar esses métodos requer que você interaja mais com o Xcode e gere seu próprio token para Push To Start com Swift. Você pode encontrar um guia sobre isso [aqui](https://github.com/OneSignal/OneSignal-iOS-SDK/pull/1377#:~:text=Alternative%20\(low%20level\)%20method%20to%20setup%20Live%20Activities%20with%20OneSignal).