O userNotificationCenter(:willPresent:withCompletionHandler:) é um método disponível no ambiente Apple que permite personalizar a exibição de notificações push antes de serem apresentadas ao usuário. Ele faz parte do framework UserNotifications, introduzido no iOS 10.

Esse método é chamado quando uma notificação push é recebida enquanto o aplicativo está em primeiro plano. Ele permite que você decida se a notificação deve ser exibida imediatamente, se deve ser modificada antes de ser exibida ou se deve ser ignorada.

Para utilizar o userNotificationCenter(:willPresent:withCompletionHandler:), siga os passos abaixo:

1. Importe o framework UserNotifications no seu projeto:

import UserNotifications

2. Implemente o delegate UNUserNotificationCenterDelegate no seu objeto delegate (normalmente AppDelegate):

class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
    // ...
}

3. Defina o delegate do UNUserNotificationCenter para o seu objeto delegate:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    UNUserNotificationCenter.current().delegate = self
    // ...
    return true
}

4. Implemente o método userNotificationCenter(:willPresent:withCompletionHandler:) no seu objeto delegate:

func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    // Personalize a exibição da notificação aqui
    // Utilize o completionHandler para indicar as opções de apresentação da notificação
    // Por exemplo, para exibir a notificação com som e alerta:
    completionHandler([.sound, .alert])
}

No código acima, você pode personalizar a exibição da notificação de acordo com suas necessidades. O completionHandler é um closure que deve ser chamado para indicar as opções de apresentação da notificação. Você pode especificar se a notificação deve ser exibida com som, alerta, badge ou nenhuma dessas opções.

É importante lembrar que o método userNotificationCenter(:willPresent:withCompletionHandler:) só é chamado quando o aplicativo está em primeiro plano. Se o aplicativo estiver em segundo plano ou fechado, a notificação será exibida de acordo com as configurações padrão.

Alternativas ou equivalentes viáveis no ambiente Apple:

• Caso você queira personalizar a exibição de notificações push quando o aplicativo está em segundo plano ou fechado, você pode utilizar o método userNotificationCenter(:didReceive:withCompletionHandler:) no lugar do userNotificationCenter(:willPresent:withCompletionHandler:). Esse método é chamado quando uma notificação push é recebida, independentemente do estado do aplicativo.