【Swift】UNMutableNotificationContent()とは？使い方や引数の意味、活用シーンをわかりやすく解説！

2025年8月30日 2025年8月30日

iOSで通知を表示したい場合、その通知内容（タイトルや本文、音など）を定義するのが UNMutableNotificationContent() です。

この記事では UNMutableNotificationContent() の基本的な役割や使い方、主要なプロパティの意味、活用シーン、注意点までをわかりやすく丁寧に解説します。

UNMutableNotificationContent() とは？

UNMutableNotificationContent は、ローカル通知またはプッシュ通知を作成する際に使用する「通知の中身（コンテンツ）」を表すクラスです。

UserNotifications フレームワークに含まれています。

通知に表示するタイトル、本文、音、バッジ、カテゴリ、添付ファイルなどをまとめて設定できます。

このオブジェクトを UNNotificationRequest に渡すことで、実際に通知が表示されるようになります。

具体例：通知内容を定義してスケジュールする

以下のコードは、5秒後にローカル通知を表示する例です。

import UserNotifications

let content = UNMutableNotificationContent()
content.title = "お知らせ"
content.body = "これは5秒後に届くローカル通知です"
content.sound = .default

let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 5, repeats: false)
let request = UNNotificationRequest(identifier: "sampleNotification", content: content, trigger: trigger)

UNUserNotificationCenter.current().add(request) { error in
    if let error = error {
        print("通知の追加に失敗: \(error.localizedDescription)")
    }
}

import UserNotifications

let content = UNMutableNotificationContent()

content.title = "お知らせ"

content.body = "これは5秒後に届くローカル通知です"

content.sound = .default

let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 5, repeats: false)

let request = UNNotificationRequest(identifier: "sampleNotification", content: content, trigger: trigger)

UNUserNotificationCenter.current().add(request) { error in

if let error = error {

print("通知の追加に失敗: \(error.localizedDescription)")

}

このように、UNMutableNotificationContent を使って通知の中身を定義し、それを UNNotificationRequest に渡して登録する流れになります。

主要なプロパティとその意味

UNMutableNotificationContent には多数の設定項目（プロパティ）があります。

ここではよく使われる主要なものをまとめて紹介します。

プロパティ名	型	説明
`title`	`String`	通知のタイトル（太字で表示）
`subtitle`	`String`	サブタイトル（小さめの文字で表示）
`body`	`String`	通知の本文（メッセージ内容）
`sound`	`UNNotificationSound`	通知音（例：`.default`）
`badge`	`NSNumber`	アプリアイコンに表示するバッジの数値
`categoryIdentifier`	`String`	アクション付き通知で使用するカテゴリID
`userInfo`	`[AnyHashable: Any]`	通知に付加する追加情報（アプリで後から参照可能）
`attachments`	`[UNNotificationAttachment]`	通知に画像や動画などのメディアを添付可能