Zum Inhalt springen
BenutzerhandbücherSupport Demo anfordern Anmelden
Pushwoosh.com

Modale Rich Media für iOS

Ab der Pushwoosh SDK-Version 6.7.5 haben Sie die Möglichkeit, modale Rich Media zu senden.

Wir führen neue modale Rich Media ein, die angepasst werden können. Die neuen modalen Rich Media blockieren den Bildschirm nicht vollständig und können an verschiedenen Stellen des Bildschirms positioniert werden (oben, unten und in der Mitte).

Weitere Informationen zu Rich-Media-Seiten finden Sie in unserem Leitfaden.

Konfiguration

Anchor link to
//for silent push notifications
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    Pushwoosh.configure.handlePushReceived(userInfo)
    completionHandler(.noData)
}

Option 1: Info.plist-Konfiguration

Anchor link to

Um die Anzeige von modalen Rich Media zu aktivieren, setzen Sie den Parameter Pushwoosh_RICH_MEDIA_STYLE in Ihrer info.plist und weisen Sie ihm den Wert MODAL_RICH_MEDIA zu.

Info.plist:

<key>Pushwoosh_RICH_MEDIA_STYLE</key>
<string>MODAL_RICH_MEDIA</string>

Option 2: Programmatische Konfiguration (SDK 7.0.14+)

Anchor link to

Sie können den Präsentationsstil für Rich Media auch programmatisch in Ihrer AppDelegate konfigurieren:

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {


    // Set modal presentation style
    Pushwoosh.media.setRichMediaPresentationStyle(.modal)


    // Configure modal window appearance
    Pushwoosh.media.modalRichMedia.configure(
        position: .PWModalWindowPositionBottom,
        presentAnimation: .PWAnimationPresentFromBottom,
        dismissAnimation: .PWAnimationDismissDown
    )


    Pushwoosh.configure.registerForPushNotifications()
    return true
}

Standardmäßig werden modale Rich Media in der Mitte des Bildschirms mit einer Erscheinungsanimation von unten nach oben angezeigt.

Positionierung von modalen Rich Media

Anchor link to

Modale Rich Media können an verschiedenen Stellen auf dem Bildschirm positioniert werden.

/**
 Enum, das die möglichen Positionen für die Anzeige eines modalen Fensters definiert.


 - `PWModalWindowPositionTop`: Das modale Fenster erscheint am oberen Bildschirmrand, innerhalb des sicheren Bereichs.
 - `PWModalWindowPositionCenter`: Das modale Fenster erscheint in der Mitte des Bildschirms, innerhalb des sicheren Bereichs.
 - `PWModalWindowPositionBottom`: Das modale Fenster erscheint am unteren Bildschirmrand, innerhalb des sicheren Bereichs.
 - `PWModalWindowPositionBottomSheet`: Das modale Fenster erscheint ganz unten am Bildschirmrand und ignoriert den sicheren Bereich.
 - `PWModalWindowPositionDefault`: Die Standardposition ist die Mitte des Bildschirms, innerhalb des sicheren Bereichs.
 */
typedef NS_ENUM(NSInteger, ModalWindowPosition) {
    PWModalWindowPositionTop,       // Erscheint am oberen Bildschirmrand (innerhalb des sicheren Bereichs)
    PWModalWindowPositionCenter,    // Erscheint in der Mitte des Bildschirms (innerhalb des sicheren Bereichs)
    PWModalWindowPositionBottom,    // Erscheint am unteren Bildschirmrand (innerhalb des sicheren Bereichs)
    PWModalWindowPositionBottomSheet, // Erscheint ganz unten am Bildschirmrand (ignoriert den sicheren Bereich)
    PWModalWindowPositionFullScreen, // Vollbild, ignoriert die Ränder des sicheren Bereichs
    PWModalWindowPositionDefault    // Standardposition (Mitte des Bildschirms, innerhalb des sicheren Bereichs)
};

Das folgende Beispiel zeigt eine modale Rich Media, die am oberen Bildschirmrand angezeigt wird.

Die Erscheinungsanimationen für modale Rich Media umfassen:

typedef NS_ENUM(NSInteger, PresentModalWindowAnimation) {
    PWAnimationPresentFromBottom,
    PWAnimationPresentFromTop,
    PWAnimationPresentFromRight,
    PWAnimationPresentFromLeft,
    PWAnimationPresentNone
};

Die Schließanimationen für modale Rich Media umfassen:

typedef NS_ENUM(NSInteger, DismissModalWindowAnimation) {
    PWAnimationDismissDown,
    PWAnimationDismissUp,
    PWAnimationDismissLeft,
    PWAnimationDismissRight,
    PWAnimationCurveEaseInOut,
    PWAnimationDismissNone,


    /**
     * Die standardmäßige Schließanimation ist `PWAnimationCurveEaseInOut`
     */
    PWAnimationDismissDefault
};

Das folgende Beispiel zeigt die Anzeige einer modalen Rich Media am unteren Bildschirmrand mit einer Erscheinungsanimation von links nach rechts und einer Schließanimation nach rechts:

Zusätzliche Parameter für modale Rich Media

Anchor link to

Zusätzliche Parameter für die Anzeige von modalen Rich Media umfassen Optionen wie das Hinzufügen von haptischem Feedback vom Typ Vibration, das Aktivieren von Wischgesten und das Einstellen eines automatischen Schließ-Timers nach einer bestimmten Dauer.

// Haptischer Feedback-Typ
Pushwoosh.media.modalRichMedia.setHapticFeedbackType(.PWHapticFeedbackLight)


// Wischrichtungen zum Schließen
Pushwoosh.media.modalRichMedia.setDismissSwipeDirections([
    NSNumber(value: DismissSwipeDirection.PWSwipeDismissDown.rawValue),
    NSNumber(value: DismissSwipeDirection.PWSwipeDismissUp.rawValue)
])


// Eckradius für Rich Media festlegen
let topCorners = PWCornerTypeTopLeft.rawValue | PWCornerTypeTopRight.rawValue
Pushwoosh.media.modalRichMedia.setCornerType(CornerType(rawValue: topCorners), withRadius: 16)


// Modale Rich Media nach N Sekunden schließen
Pushwoosh.media.modalRichMedia.closeAfter(3)

Haptische Feedback-Typen:

typedef NS_ENUM(NSInteger, HapticFeedbackType) {
    PWHapticFeedbackLight,         // Leichtes Vibrationsfeedback
    PWHapticFeedbackMedium,        // Mittleres Vibrationsfeedback
    PWHapticFeedbackHard,          // Starkes Vibrationsfeedback
    PWHapticFeedbackNone           // Vibration ist aus (Standard)
};

Wischrichtungen:

typedef NS_ENUM(NSInteger, DismissSwipeDirection) {
    PWSwipeDismissDown,
    PWSwipeDismissUp,
    PWSwipeDismissLeft,
    PWSwipeDismissRight,
    PWSwipeDismissNone
};

PWRichMediaPresentingDelegate

Anchor link to

Um die Warteschlange der modalen Rich Media zu verwalten, müssen Sie die Delegate-Methoden von PWRichMediaPresentingDelegate implementieren. Bei Verwendung dieser Funktionalität werden modale Rich Media nacheinander präsentiert, und die nächste wird erst angezeigt, wenn der Benutzer die aktuelle schließt. Sobald der Benutzer die präsentierte Rich Media schließt, wird die nächste, die Teil einer anderen Push-Benachrichtigung war, angezeigt.

import UIKit
import PushwooshFramework


@main
class AppDelegate: UIResponder, UIApplicationDelegate, PWRichMediaPresentingDelegate {


    var richMediaQueue: [PWRichMedia] = []
    var isPresenting = false


    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {


        // Modale Rich Media konfigurieren
        Pushwoosh.media.setRichMediaPresentationStyle(.modal)
        Pushwoosh.media.modalRichMedia.configure(
            position: .PWModalWindowPositionBottom,
            presentAnimation: .PWAnimationPresentFromBottom,
            dismissAnimation: .PWAnimationDismissDown
        )


        // Delegate festlegen
        Pushwoosh.media.modalRichMedia.delegate = self


        Pushwoosh.configure.registerForPushNotifications()
        return true
    }


    // MARK: - PWRichMediaPresentingDelegate


    func richMediaManager(_ richMediaManager: PWRichMediaManager, shouldPresent richMedia: PWRichMedia) -> Bool {
        if !richMediaQueue.contains(where: { $0 === richMedia }) {
            richMediaQueue.append(richMedia)
        }
        return !isPresenting
    }


    func richMediaManager(_ richMediaManager: PWRichMediaManager, didPresent richMedia: PWRichMedia) {
        isPresenting = true
    }


    func richMediaManager(_ richMediaManager: PWRichMediaManager, didClose richMedia: PWRichMedia) {
        isPresenting = false


        if let idx = richMediaQueue.firstIndex(where: { $0 === richMedia }) {
            richMediaQueue.remove(at: idx)
        }


        // Nächste Rich Media in der Warteschlange präsentieren
        if let nextRichMedia = richMediaQueue.first {
            Pushwoosh.media.modalRichMedia.present(nextRichMedia)
        }
    }


    func richMediaManager(_ richMediaManager: PWRichMediaManager, presentingDidFailFor richMedia: PWRichMedia, withError error: Error) {
        richMediaManager(richMediaManager, didClose: richMedia)
    }
}