iOS 10以降のNotificationの基本

はじめに

これまで、ローカル通知にはUIUserNotificationを利用してきました
が、iOS 10ではdeprecatedになりました
ここでは、iOS 10以降のローカル通知の方法の基本を記載します
プッシュ通知も同様のAPIを使ってますが、今回はより仕組みの単純なローカル通知で説明します

検証環境

Xcode 8.2.1
iOS 10.2
Swift 3

大きく変わった見た目

ダイアログ形式はなくなって、見た目上はバナーもアラートも画面上部の表示に変わりました
- バナーは5秒程度でHOME画面から表示が消える
- アラートはユーザが何らかのアクションを取るまでHOME画面に残る

登場するコンポーネント

これらはUIKitではなくUserNotificationsフレームワークに含まれるので、利用にはimportが必要です

通知を行うための準備

ユーザへ通知許可を要求

これまでと同様、通知を行うためにはユーザに許可を得る必要があります
- 場所的には、アプリ起動時に呼ばれるapplication(_:didFinishLaunchingWithOptions:)がよいでしょう

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

    // notification center (singleton)
    let center = UNUserNotificationCenter.current()

    // ------------------------------------
    // 前準備: ユーザに通知の許可を求める
    // ------------------------------------

    // request to notify for user
    center.requestAuthorization(options: [.alert, .badge, .sound]) { (granted, error) in
        if granted {
            print("Allowed")
        } else {
            print("Didn't allowed")
        }
    }

    return true
}

（オプション）カテゴリを用意

単純な通知は、ただのバナー状であり、タップすると対象のアプリが起動します
が、カスタムAction（ボタンだと思えばOK）を用意した雛形を準備しておくと、通知を発行する際に利用できます
- 別の記事で、いずれ書きたいと思います

ローカル通知を登録

通知自体は、UNNotificationRequestとして作成します（以下request）
requestには、以下の情報を含めます
- 通知の内容
  - UNMutableNotificationContent
- 通知のタイミング（When/Where）
  - UN○○○○NotificationTriggerシリーズ
requestをUNUserNotificationCenterにadd(_:withCompletionHandler:)することで、ローカル通知を登録します
- 指定の時間や場所で、通知されるようになる

@IBAction func setNotification(_ sender: UIButton) {

    let seconds = Int(segment.titleForSegment(at: segment.selectedSegmentIndex)!)!

    // ------------------------------------
    // 通知の発行: タイマーを指定して発行
    // ------------------------------------

    // content
    let content = UNMutableNotificationContent()
    content.title = "It's time."
    content.subtitle = "\(seconds) seconds elapsed!"
    content.body = "I told you now because you had set \(seconds) seconds before."
    content.sound = UNNotificationSound.default()

    // trigger
    let trigger = UNTimeIntervalNotificationTrigger(timeInterval: Double(seconds),
                                                    repeats: false)

    // request includes content & trigger
    let request = UNNotificationRequest(identifier: "TIMER\(seconds)",
                                        content: content,
                                        trigger: trigger)

    // schedule notification by adding request to notification center
    let center = UNUserNotificationCenter.current()
    center.add(request) { (error) in
        if let error = error {
            print(error.localizedDescription)
        }
    }
}

（オプション）カスタムAction選択時の処理を実装

通知をタップしたらアプリが表示されるだけであれば、これは不要です
UNUserNotificationCenterDelegateを利用すると、カスタムActionに対する処理が実装できます
- 通常、該当アプリがフォアグラウンドの場合には通知は表示されませんが、表示できるようにすることも可能です
これも、別記事でまとめる予定です

まとめ

APIが整理されて、使いやすくなりました
- delegateとの組み合わせで、コードも整理できそうです
Extension Pointも追加されているので、通知済みの内容を更新もできるようになりました
今回は単純に通知を出すだけでしたが、カスタマイズなどもまたまとめたいと思います
今回作成したサンプルコードは、GitHubに置きました
- UserNotificationSample

92IT

Just love IT.

iOS 10以降のNotificationの基本