**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. Добавьте конфигурацию `PushwooshForegroundPush` в 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)
}
}
}
```
Использование метода `foregroundNotificationWith`
Метод `foregroundNotificationWith` позволяет отображать пользовательское push-уведомление в активном режиме с настраиваемым стилем, продолжительностью и тактильной обратной связью.
Сигнатура метода (Swift / Objective-C):
```swift
@objc
static func foregroundNotificationWith(
style: PWForegroundPushStyle,
duration: Int,
vibration: PWForegroundPushHapticFeedback,
disappearedPushAnimation: PWForegroundPushDisappearedAnimation
)
```
`Параметры:`
1. `style` (`PWForegroundPushStyle`)
* В настоящее время доступен только `style1`.
2. `duration` (`Int`)
* Указывает, как долго уведомление будет отображаться перед исчезновением (в секундах).
3. `vibration` (`PWForegroundPushHapticFeedback`)
* Управляет тактильной обратной связью при показе уведомления. Доступные опции:
```swift
case none // Без вибрации
case light // Легкая вибрация
case medium // Средняя вибрация
case heavy // Сильная вибрация
case soft // Мягкая вибрация
case rigid // Резкая вибрация
case notification // Стандартная вибрация уведомления
```
4. `disappearedPushAnimation` (`PWForegroundPushDisappearedAnimation`)
* Анимация исчезновения push-уведомления
```swift
case balls = 0
case regularPush
```
### 4. Реализация метода делегата `didTapForegroundPush`
Для обработки нажатий пользователя на пользовательские push-уведомления в активном режиме реализуйте метод протокола `PWForegroundPushDelegate`:
```swift
// Обработка нажатия на push-уведомление в активном режиме
func didTapForegroundPush(_ userInfo: [AnyHashable : Any]) {
print("Foreground custom push: \(userInfo)")
// Выполните любое действие, например, переход на определенный экран
// navigateToScreen(for: userInfo)
}
```
Примечания:
* Этот метод вызывается, когда пользователь нажимает на пользовательское push-уведомление в активном режиме.
* `userInfo` содержит полезную нагрузку уведомления.
* Убедитесь, что вы установили `Pushwoosh.ForegroundPush.delegate = self` после конфигурации.
### 5. Необязательные параметры для настройки push-уведомлений в активном режиме
Модуль `PushwooshForegroundPush` предоставляет несколько необязательных параметров для настройки внешнего вида и поведения ваших push-уведомлений в активном режиме. Их можно установить глобально через статические свойства.
| Свойство | Тип | Описание | По умолчанию |
|---|---|---|---|
| useLiquidView | Bool | Использовать вид Liquid Glass на iOS 26. | false |
| gradientColors | [UIColor]? | Необязательный массив цветов для градиентного фона. | nil |
| backgroundColor | UIColor? | Цвет фона для push-уведомления. Если nil и gradientColors не установлен, используется градиент по умолчанию. | Системный градиент по умолчанию |
| usePushAnimation | Bool | Анимировать ли push-уведомление при показе. | true |
| titlePushColor | UIColor? | Цвет текста заголовка уведомления. По умолчанию системный белый, если nil. | white |
| messagePushColor | UIColor? | Цвет текста сообщения уведомления. По умолчанию системный белый, если nil. | white |
| titlePushFont | UIFont? | Шрифт текста заголовка уведомления. По умолчанию системный шрифт, если nil. | Системный шрифт по умолчанию |
| messagePushFont | UIFont? | Шрифт текста сообщения уведомления. По умолчанию системный шрифт, если nil. | Системный шрифт по умолчанию |