PricingLoginStart free
Swift Academy · Lektion

Håndtering af notifikationspayloads

Reagér på notifikationer i forgrunden og baggrunden.

Lektion 2 af 413 trin

Håndtering af notifikationspayloads er en gratis Swift Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Swift Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Swift Academy-kurset indeholder 4 lektioner i alt.

Payloadstruktur

En fjernnotifikation er en JSON-ordbog, som din server sender til APNs. Den reserverede aps-nøgle indeholder det indhold, brugeren kan se — alarm, lyd og badge — mens andre nøgler på samme niveau indeholder dine egne data, f.eks. et id på det element, der skal åbnes.

// Example payload JSON:
// {
//   "aps": { "alert": { "title": "Hi", "body": "..." },
//            "sound": "default", "badge": 1 },
//   "itemId": "42"
// }

aps-ordbogen

Inde i aps kan alert være en streng eller et objekt med titel, brødtekst og undertitel. sound, badge og flag som content-available og mutable-content findes også her. Alt uden for aps definerer du selv.

// aps keys:
//   alert: { title, subtitle, body }
//   sound: "default" or critical sound object
//   badge: Int
//   content-available: 1  (silent / background)
//   mutable-content: 1    (allow modification)

Levering i forgrunden

Som standard undertrykkes en notifikation, der ankommer, mens appen er i forgrunden. Hvis du vil vise den alligevel, skal du implementere delegatens willPresent og returnere de præsentationsindstillinger, du ønsker, f.eks. et banner og en lyd.

import UserNotifications
func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification
) async -> UNNotificationPresentationOptions {
    return [.banner, .sound, .badge]
}

Reaktion på et tryk

Når brugeren trykker på en notifikation, uanset om appen var i baggrunden eller var afsluttet, kører delegatens didReceive response. Det er her, du læser payloaden og navigerer til den rigtige skærm.

import UserNotifications
func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse
) async {
    let info = response.notification.request
        .content.userInfo
    if let id = info["itemId"] as? String {
        print("open item", id)
    }
}

Læsning af userInfo

Hele payloaden, inklusive dine egne nøgler, er tilgængelig som content.userInfo — en ordbog af typen [AnyHashable: Any]. Typekonvertér hver værdi omhyggeligt; brug aldrig tvangsudpakning, fordi en forkert payload ikke må få appen til at gå ned.

import UserNotifications
func route(_ userInfo: [AnyHashable: Any]) {
    guard let screen = userInfo["screen"] as? String
    else { return }
    switch screen {
    case "profile": print("go to profile")
    case "cart":    print("go to cart")
    default:        break
    }
}

Stille notifikationer i baggrunden

Hvis du indstiller content-available: 1 og udelader en alert, får du en stille pushnotifikation, der vækker appen i baggrunden, så den kan hente data uden nogen brugerflade. Systemet begrænser disse notifikationer, og de kræver baggrundstilstanden Remote notifications.

// Silent payload — no alert, just a wake-up:
// { "aps": { "content-available": 1 }, "sync": true }
let silent = "content-available wakes app quietly"
_ = silent

Håndtering af baggrundshentning

En stille pushnotifikation ankommer i appdelegatens asynkrone metode didReceiveRemoteNotification. Du henter data og returnerer en UIBackgroundFetchResult, så systemet ved, om der kom nye data, og kan planlægge fremtidige opvågninger.

import UIKit
func application(
    _ app: UIApplication,
    didReceiveRemoteNotification userInfo: [AnyHashable: Any]
) async -> UIBackgroundFetchResult {
    // fetch fresh data here
    return .newData
}

Ændret indhold og serviceudvidelser

Med mutable-content: 1 kan en Notification Service Extension opfange pushnotifikationen før visning — for at dekryptere brødteksten, hente et billedbilag eller omskrive titlen. Udvidelsen har kort tid til at blive færdig.

// Service extension entry point (UNNotificationServiceExtension):
// override didReceive(_:withContentHandler:)
//   modify bestAttemptContent, then call contentHandler
let mutable = "mutable-content enables interception"
_ = mutable

Lokalisering af notifikationen

Hvis teksten skal lokaliseres på serversiden, skal du sende title-loc-key og loc-key, der henviser til nøgler i appens lokaliseringsstrenge, samt loc-args til indsættelse af værdier. Enheden viser dem på brugerens sprog, uden at du behøver sende en forhåndsoversat tekst.

// Localized alert payload:
// "alert": {
//   "loc-key": "NEW_MESSAGE",
//   "loc-args": ["Ada"]
// }
let localized = "loc-key resolves on device"
_ = localized

Opdatering af badge

Værdien badge angiver tallet på appikonet. Hvis du sender badge: 0, rydder du det. Du kan også indstille det i kode via setBadgeCount, når brugeren har læst indhold, så badget stemmer overens med antallet af ulæste elementer.

import UserNotifications
func clearBadge() async {
    try? await UNUserNotificationCenter.current()
        .setBadgeCount(0)
}

Robust håndtering

Saml delene: vis notifikationer i forgrunden, dirigér brugeren ved tryk, og valider hver typekonvertering. Håndteringen går aldrig ned på grund af uventede payloads og udtrækker altid det, den kan.

import UserNotifications
func handleTap(_ response: UNNotificationResponse) {
    let info = response.notification.request
        .content.userInfo
    guard let id = info["itemId"] as? String else {
        print("no item id; open home")
        return
    }
    print("navigate to item", id)
}

Hurtigt tjek

Husk, hvordan du reagerer på et tryk på en notifikation.

Besvar den i den interaktive lektion

Opsummering

Du har lært at håndtere payloads:

  • Ordbogen aps indeholder det indhold, brugeren kan se; andre nøgler indeholder dine data, som læses via userInfo.
  • Tilsidesæt willPresent for at vise notifikationer i forgrunden og didReceive response for at håndtere tryk.
  • content-available: 1 starter stille baggrundshentninger, der returnerer en UIBackgroundFetchResult.
  • mutable-content aktiverer en serviceudvidelse; loc-key lokaliserer teksten på enheden.
Gratis at komme i gang

Lær Swift med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
122
Lektioner
409
Start gratisSe hele kurset

Ofte stillede spørgsmål

Er lektionen “Håndtering af notifikationspayloads” gratis?

Ja — alle 3 lektioner i læringssporet Swift Academy, inklusive “Håndtering af notifikationspayloads”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Swift Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Håndtering af notifikationspayloads”?

Reagér på notifikationer i forgrunden og baggrunden. Du øver dig i Swift Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Swift Academy?

Der kræves ingen tidligere erfaring. Swift Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “Håndtering af notifikationspayloads”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Swift Academy-lektion?

Ja. Alle Swift Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Registrering til push-notifikationer
  2. Håndtering af notifikationspayloads
  3. Baggrundsopgaver og opdatering
  4. Notifikationshandlinger og kategorier
← Tilbage til Swift Academy