【Swift】requestAuthorization()とは？使い方や引数の意味をわかりやすく解説！

2025.08.30 2025.08.30

iOSでローカル通知やプッシュ通知を使うには、まずユーザーの許可を得る必要があります。

このとき使用されるのが UNUserNotificationCenter.current().requestAuthorization() です。

この記事では、requestAuthorization() の基本的な役割や使い方、主要な引数の意味をわかりやすく丁寧に解説します。

requestAuthorization() とは？

requestAuthorization() は、ユーザーに通知の許可を求めるためのメソッドです。

具体的には、UserNotificationsフレームワーク に含まれる UNUserNotificationCenter クラスのインスタンスメソッド。

このメソッドを使うことで、アプリが通知を送信できるようにユーザーの同意を得るプロンプトを表示します。

一度許可を得た後でないと、UNNotificationRequest を使って通知をスケジュールしても表示されません。

ユーザーの同意がある場合のみ通知機能が有効になるため、通知を使うすべてのアプリで最初に呼び出す必要があります。

具体例：通知の許可をリクエストする

以下は、通知の許可を求めるための基本的なサンプルコードです。

import UserNotifications

UNUserNotificationCenter.current().requestAuthorization(
    options: [.alert, .sound, .badge]
) { granted, error in
    if let error = error {
        print("通知の許可取得エラー: \(error.localizedDescription)")
        return
    }

    if granted {
        print("通知が許可されました")
    } else {
        print("通知は拒否されました")
    }
}

import UserNotifications

UNUserNotificationCenter.current().requestAuthorization(

options: [.alert, .sound, .badge]

) { granted, error in

if let error = error {

print("通知の許可取得エラー: \(error.localizedDescription)")

return

}

if granted {

print("通知が許可されました")

} else {

print("通知は拒否されました")

}

このコードでは、通知の3つの種類（アラート、サウンド、バッジ）について許可を求めています。

ユーザーが許可または拒否を選ぶと、その結果がクロージャ内の granted に返されます。

granted == true → ユーザーが通知を許可した場合（通知を送信できるようになる）
granted == false → ユーザーが通知を拒否した場合（通知を送信しても表示されない）

つまり granted は Bool型（true/false） で、通知の利用が許可されたかどうかを判定するための値です。

主要な引数とその意味

requestAuthorization() メソッドには次の2つの引数があります。

引数名	型	説明
options	UNAuthorizationOptions	許可を求める通知の種類（配列形式）
completionHandler	(Bool, Error?) -> Void	ユーザーの応答とエラーを受け取るクロージャ

options には以下のような種類があります。

オプション名	内容
`.alert`	通知バナーなどのアラートを表示
`.sound`	通知音を鳴らす
`.badge`	アプリアイコンにバッジを表示
`.provisional`	サイレント通知の許可（ユーザーに表示せず通知を試す）
`.criticalAlert`	緊急アラート（特別な許可が必要）

通常のアプリでは .alert, .sound, .badge の3つを指定すれば十分です。

requestAuthorization() の活用シーン

このメソッドは、通知を活用するすべてのアプリにおいて不可欠なステップです。

特に以下のような場面で使われます。

ローカル通知を使ってリマインダーやタイマーを表示したいとき
プッシュ通知（リモート通知）を導入して、サーバーから通知を送りたいとき
通知許可の状態をチェックし、UIでユーザーにリクエストを促したいとき
許可の状態に応じて通知設定画面への誘導を行いたい場合

例えば「最初の起動時に許可をリクエストする」「設定画面で再リクエストする」など、ユーザー体験に合わせて柔軟に呼び出すタイミングを調整できます。

使用時の注意点

便利な requestAuthorization() ですが、いくつかの注意点があります。

ユーザーが一度拒否すると、再度許可を求めるプロンプトは表示されない
拒否後に通知を有効にするには、ユーザー自身が「設定」アプリから変更する必要がある
許可状態の確認には下記のように getNotificationSettings() を使う

UNUserNotificationCenter.current().getNotificationSettings { settings in
    switch settings.authorizationStatus {
    case .authorized:
        print("通知は許可されています")
    case .denied:
        print("通知は拒否されています")
    case .notDetermined:
        print("通知の許可状態は未決定です")
    default:
        break
    }
}