プッシュ通知のプライマー

プッシュ通知のプライマー

ユーザーがAppを最大限に活用できるよう、重要なイベントやアップデートのプッシュ通知を送ったり、Appが最新の状態で起動するようにバックグラウンドでデータを送信したりしましょう。通知を使って、タイムリーで適切な情報をアラートする方法を学びましょう。アラートとバックグラウンド通知の違い、Appに統合する方法や、ジョブに適したAPIを使うことでミスを回避する方法をお伝えします。

リソース
関連ビデオ

WWDC23
- プッシュ通知コンソールについて
ダウンロード

こんにちは WWDCへようこそ “プッシュ通知のプライマー” エリオット･ガーナーですこのセッションではプッシュ通知についてお話ししますまずプッシュ通知の概要プッシュ通知とは何なのか― なぜそれを使用するのかについて説明しますそれからアプリケーションへ追加する方法をお話ししますプッシュ通知はアプリケーションを魅力的でインタラクティブなものにしますアプリケーションにリアルタイムで更新を届ける機能を提供しますこれによりアプリケーションの更新が― 発生する際にダイナミックな体験が可能になりますではアプリケーションにプッシュ通知を追加する利点はなんでしょう？ひとつはアプリケーションが最前面になくてもよいことですプッシュ通知はアプリケーションの状態に関係なく通達され必要であればアプリケーションを起動しますプッシュ通知は省電力でカスタマーと関わる素晴らしい方法ですプッシュ通知には２種類あります alert通知とバックグラウンド通知です alert通知は視覚的にalertを通達しアプリケーションがカスタマイズできる方法で相互作用しますバックグラウンド通知はコンテンツを最新の状態に保つためにアプリケーションが最前面にない時にランタイムを受け取ることができますそれでは alert通知からはじめましょう alert通知は目に見えるalertを通達しアプリケーションの更新を提供しますこの通知は相互作用可能な新しい情報について使用されるべきですこのalertはアプリケーションの実行を必要とせずアプリケーションの状態に関わらず表示されますそして最も重要なのは完全にカスタマイズ可能だということです alertの見た目や相互作用能力はあなた次第です alert通知のためのアプリケーションの設定を開始する方法を見ていきましょうはじめにリモート通知を登録する必要がありますこれはデバイスを― Apple Push Notificationシステム(APNs) へ登録し― デバイストークンをアプリケーションへ返しますこのトークンはデバイスを識別するために使用され通知の対象にできます次に AppDelegateに― UNUserNotificationCenterDelegateを宣言します完了すると AppDelegateを通知センターのデリゲートとして割り当てますこれによりalertが開いた際アプリケーションに通知されます registerForRemoteNotificationsを呼び出すとこれらの２つのうち１つのメソッドでコールバックを受け取りますデバイスへのトークンの取得に失敗すると didFailToRegisterFor RemoteNotificationsWithErrorが― 登録の失敗理由が示されたエラーと共に呼び出されます
トークンの取得に成功するとそのトークンをバックエンドのプッシュサーバに送りデバイスに通知を送ります例を見てみましょうデバイストークンがデータオブジェクトとしてアプリケーションに通達されますサーバにそれを送るには文字列に変換する必要がありますデータをコンポーネントに分割することで可能ですコンポーネントを16進数の文字列に分割しそれから単一の文字列に結合し直しますそしてその文字列をURLQueryに追加し完全修飾エンドポイントを作成します
次にURLSessionを実行して― そのトークンをサーバへ送信しデータベースに登録します最後にデバイスが通知を受信する前に― アプリケーションがalertを表示する権限を要求する必要があります requestAuthorizationを呼び出すとアプリケーションがalertを表示できるかたずねるプロンプトが表示されます
その決定の結果がcompletionHandlerに渡されデバイス設定で設定されますこのメソッドを連続して呼び出すとデバイス設定のステータスが返されプロンプトは表示されませんご覧のとおりこの関数はalertを表示し音を鳴らしアプリケーションアイコンにバッジを表示する権限を求めていますコンテキストがある場合のみアクションへ応答して承認を要求しますこのコンテキストでユーザーの許可を得られる可能性がはるかに高くなります通知ペイロードの処理方法をご説明する前にペイロードの例を見てみましょうレストランのアプリケーションを構築していてユーザーに新着のスペシャルを通知したいとします
ご覧のとおりalertが― アボカドベーコンバーガーが発売されたことを知らせていますこのペイロードを１つずつ解析して確実に理解しましょう最初にapsディクショナリです apsディクショナリはデバイスに通知のレンダリング方法を指示します apsディクショナリの内側は alertディクショナリですこれは通知に使用するテキストをシステムに伝えますその内側にタイトルと本文フィールドがありますタイトルフィールドは短い文字列で通知の目的を示しますこれは短く分かりやすいものである必要があります本文フィールドはalertメッセージの完全な説明文です次にサウンドフィールドですこのフィールドはオプションで alertを受け取る際にデバイスで音を再生させたい場合含むべきですデフォルトサウンドを使用したければこのように“default”を使用しますまたカスタムサウンドも提供できます次にバッジフィールドですこれはアイコンのバッジを変更するのに使用されるオプションのフィールドですこれは絶対値でアプリケーションアイコンに表示されますこの値はプログラムで変更できるので alertが開いたら― 通知を処理する際値を“0”に設定します apsフィールドの外側には通知と一緒に提供したい― カスタムデータがありますここではアプリケーションが今日のスペシャルの内容とその価格を示していますではペイロードがどのように見えるか分かったところで通知の受信を処理する方法を調べましょう UNUserNotificationCenterDelegateメソッドです通知が開かれるたびに呼び出されますこのメソッドは completionHandlerを持っていてそれは関数から返される前に呼び出されなくてはなりませんアプリケーションに送られたペイロードは通知のコンテンツのuserInfoプロパティから取り出せますペイロードを取得したら JSONのディクショナリ表記からデータを解析しますデータが期待通りにない場合戻る前にcompletionHandlerを呼び出しますこれによりシステムに通知の開始処理の終了が伝えられますデータを取得するとアプリケーションに必要な更新を実行できます alertに関連するアプリケーションの部分を開く必要がありますこのレストランの例では alertがタップされるとアイテムがカートに追加されカートが表示されます
完了したら completionHandler呼び出してシステムに終了を伝えますこれだけです alert通知の処理と受信のためにアプリケーションに設定することはこれで全てです alert通知の実装についてはここまでにしてバックグラウンド通知についてとアプリケーションでのその使用方法をお話ししますバックグラウンド通知は alert通知に似ていますが覚えておくべき決定的な違いがいくつかありますバックグラウンド通知はプッシュ通知の受信時にアプリケーションがバックグラウンドからデータを読み込めるようにしますこれはアプリケーションを実行していない時でもアプリケーションを最新の状態に保つために使用されるべきですシステムはアプリケーションを起動しバックグラウンド更新のために必要なランタイムを提供しますしかしこれにはいくつか制限がありますシステムはアプリケーションに１日の多くのバックグラウンド操作を制限しデバイスが特定の制約下にある時バックグラウンドの更新が実行されません例えばデバイスのバッテリー残量が少ない時ですではバックグラウンド通知を処理して受信するように設定するために何をする必要があるのでしょうか？ alert通知と同様アプリケーションにデバイストークンを取得するにはアプリケーションをリモート通知に登録する必要があります
しかし alert通知とは異なりアプリケーションに UNUserNotificationCenterDelegateを設定したり UNUserNotificationCenterに割り当てたりする必要はありません UNUserNotificationCenterDelegateは alert通知を処理する際にのみ使用するためですそしてバックグラウンド通知はここで実装されているもので全てなのでそれは必要ありません registerForRemoteNotificationsが呼び出されたためデバイストークンの受信を処理する必要があり登録のためにそのデバイスをプッシュサーバへ送信する必要がありますこれはalert通知に必要なことと全く同じですさてバックグラウンド通知のペイロードを調べてみましょうバックグラウンド通知のペイロードは alert通知のものより随分シンプルですバックグラウンド通知に必要なフィールドは apsディクショナリ内の content availableフィールドのみです
このフィールドはこれがバックグラウンド通知であり更新を実行するためにアプリケーションの起動が必要であることをシステムに伝えます alert通知のように apsディクショナリの外側をカスタムデータに使用しますそれではバックグラウンド通知を扱う方法をみてみましょうデバイスがリモート通知を受信すると didReceiveRemoteNotificationが呼び出されますバックグラウンド通知を扱うためにこのメソッドを使用します
この関数にもcompletionHandlerがありますしかし alert通知を処理する際の completionHandlerと異なり― このcompletionHandlerは１つのパラメータを持ちます
このパラメータはenumでシステムにバックグラウンド更新が失敗したかどうか― データを受信していないか新しいデータを受信したかを伝えますこれによりシステムが将来アプリケーションを起動するタイミングをうまくはかれるようになりますなのでレストランアプリケーション場合バックグラウンド通知を使用しメニュー内容を毎日最新の状態にするために毎日メニューを取得していますメニューの最新バージョンのための URL作成に失敗した場合 completionHandlerを呼び出しバックグラウンド更新が失敗したことを伝えます
URLが作成されたら今日のメニューのデータを取得するために URLSessionの作成が必要ですデータを受信しなかった場合 completionHandlerを呼び出しデータなしでバックグラウンド更新が正常に終了したことを伝えます
そうでない場合ここで更新されたメニューが読み込まれたのでアプリケーションはコンテンツの更新にそのデータを使用できますそれが完了すると completionHandlerを呼び出しシステムに― バックグラウンド更新が成功し新しいデータを取得したことを通知します
バックグラウンド通知を扱うためにアプリケーションへ実装することはこれで全てですこれでプッシュ通知とは何か― それをどう扱うのかまたどう実装するのか説明できたので問題なくアプリケーションに追加していただけるはずですデベロッパポータルでプッシュ通知を有効化しこのステップに従ってアプリケーションへプッシュ通知を追加するだけです
サンプルアプリケーションをダウンロードしてくださいこのセッションで紹介した全てのコードをご覧いただけます一通り見ていただきアプリケーションへプッシュ通知を追加する― スタートとしてご使用くださいこれらの全てを行うことでアプリケーションに豊かな体験をもたらすことができるでしょうありがとうございました

class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {

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

2:36 - UIApplicationDelegate callbacks

func application(_ application: UIApplication,
                   didFailToRegisterForRemoteNotificationsWithError error: Error) {
    // The token is not currently available.
    print("Remote notification is unavailable: \(error.localizedDescription)")
}

func application(_ application: UIApplication,
                   didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
     // Forward the token to your provider, using a custom method.
     self.forwardTokenToServer(token: deviceToken)
}

3:05 - Forward token to server

func forwardTokenToServer(token: Data) {
    let tokenComponents = token.map { data in String(format: "%02.2hhx", data) }
    let deviceTokenString = tokenComponents.joined()
    let queryItems = [URLQueryItem(name: "deviceToken", value: deviceTokenString)]
    var urlComps = URLComponents(string: "www.example.com/register")!
    urlComps.queryItems = queryItems
    guard let url = urlComps.url else {
        return
    }

    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        // Handle data
    }

    task.resume()
}

3:47 - Request authorization

@IBAction func subscribeToNotifications(_ sender: Any) {
    let userNotificationCenter = UNUserNotificationCenter.current()
    userNotificationCenter.requestAuthorization(options: [.alert, .sound, .badge]) { (granted, error) in
        print("Permission granted: \(granted)")
    }
}

4:43 - Payload JSON

{
    "aps" : {
       "alert" : {
            "title" : "Check out our new special!",
            "body" : "Avocado Bacon Burger on sale"
        },
        "sound" : "default",
        "badge" : 1,
   },
    "special" : "avocado_bacon_burger",
    "price" : "9.99"
}

6:11 - didReceive response

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            didReceive response: UNNotificationResponse,
                            withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo
    guard let specialName = userInfo["special"] as? String,
          let specialPriceString = userInfo["price"] as? String,
          let specialPrice = Float(specialPriceString) else {
        // Always call the completion handler when done.
        completionHandler()
        return
    }

    let item = Item(name: specialName, price: specialPrice)
		addItemToCart(item)
  	showCartViewController()
    completionHandler()
 }

8:16 - Register for remote notifications (Background)

class AppDelegate: UIResponder, UIApplicationDelegate {

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

9:05 - Background Notification Payload

{
    "aps" : {
       "content-available" : 1
    },
    "myCustomKey" : "myCustomData"
}

9:33 - didReceiveRemoteNotification

func application(_ application: UIApplication,
                     didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                     fetchCompletionHandler completionHandler:
                     @escaping (UIBackgroundFetchResult) -> Void) {
    guard let url = URL(string: "www.example.com/todays-menu") else {
        completionHandler(.failed)
        return
    }

    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        guard let data = data else {
            completionHandler(.noData)
            return
        }
  
        updateMenu(withData: data)
        completionHandler(.newData)
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC23