**Cocoapods**
```bash
# Uncomment the next line to define a global platform for your project
# platform :ios, '13.0'
target 'MyApp' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
pod 'PushwooshXCFramework'
pod 'PushwooshFramework/PushwooshForegroundPush'
end
```
### 3. Adicione a Configuração `PushwooshForegroundPush` no AppDelegate
```swift
import UIKit
import PushwooshFramework
import PushwooshForegroundPush
@main
class AppDelegate: UIResponder, UIApplicationDelegate, PWMessagingDelegate, PWForegroundPushDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Pushwoosh.ForegroundPush.foregroundNotificationWith(style: .style1,
duration: 5,
vibration: .notification,
disappearedPushAnimation: .balls)
Pushwoosh.ForegroundPush.delegate = self
return true
}
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageReceived message: PWMessage) {
if let payload = message.payload {
// Pushwoosh method
Pushwoosh.ForegroundPush.showForegroundPush(userInfo: payload)
}
}
}
```
Usando o Método `foregroundNotificationWith`
O método foregroundNotificationWith permite que você exiba uma notificação push customizada em primeiro plano com estilo, duração e feedback tátil configuráveis.
Assinatura do Método (Swift / Objective-C):
```swift
@objc
static func foregroundNotificationWith(
style: PWForegroundPushStyle,
duration: Int,
vibration: PWForegroundPushHapticFeedback,
disappearedPushAnimation: PWForegroundPushDisappearedAnimation
)
```
`Parâmetros:`
1. `style` (`PWForegroundPushStyle`)
* Atualmente, apenas o style1 está disponível.
2. `duration` (`Int`)
* Especifica por quanto tempo a notificação será exibida antes de desaparecer (em segundos).
3. `vibration` (`PWForegroundPushHapticFeedback`)
* Controla o feedback tátil quando a notificação é exibida. Opções disponíveis:
```swift
case none // Sem vibração
case light // Vibração leve
case medium // Vibração média
case heavy // Vibração forte
case soft // Vibração suave
case rigid // Vibração rígida
case notification // Vibração de notificação padrão
```
4. `disappearedPushAnimation` (`PWForegroundPushDisappearedAnimation`)
* Animação de desaparecimento do push
```swift
case balls = 0
case regularPush
```
### 4. Implementando o Método Delegate `didTapForegroundPush`
Para lidar com os toques do usuário em notificações push customizadas em primeiro plano, implemente o método do protocolo `PWForegroundPushDelegate`:
```swift
// Lida com o toque no push em primeiro plano
func didTapForegroundPush(_ userInfo: [AnyHashable : Any]) {
print("Foreground custom push: \(userInfo)")
// Realize qualquer ação, ex: navegar para uma tela específica
// navigateToScreen(for: userInfo)
}
```
Notas:
* Este método é chamado quando o usuário toca em um push customizado em primeiro plano.
* userInfo contém o payload da notificação.
* Certifique-se de definir `Pushwoosh.ForegroundPush.delegate = self` após a configuração.
### 5. Parâmetros Opcionais para Customizar Notificações Push em Primeiro Plano
O módulo `PushwooshForegroundPush` fornece vários parâmetros opcionais para customizar a aparência e o comportamento de suas notificações push em primeiro plano. Eles podem ser definidos globalmente através de propriedades estáticas.
| Propriedade | Tipo | Descrição | Padrão |
|---|---|---|---|
| useLiquidView | Bool | Usa a visualização Liquid Glass no iOS 26. | false |
| gradientColors | [UIColor]? | Array opcional de cores para um fundo gradiente. | nil |
| backgroundColor | UIColor? | Cor de fundo para o push. Se for nulo e gradientColors não estiver definido, o gradiente padrão é usado. | Gradiente padrão do sistema |
| usePushAnimation | Bool | Se deve animar o push quando exibido. | true |
| titlePushColor | UIColor? | Cor do texto do título da notificação. O padrão é o branco do sistema se for nulo. | white |
| messagePushColor | UIColor? | Cor do texto da mensagem da notificação. O padrão é o branco do sistema se for nulo. | white |
| titlePushFont | UIFont? | Fonte do texto do título da notificação. O padrão é a fonte do sistema se for nulo. | Fonte padrão do sistema |
| messagePushFont | UIFont? | Fonte do texto da mensagem da notificação. O padrão é a fonte do sistema se for nulo. | Fonte padrão do sistema |