Mobile Notifications を利用したローカルプッシュ通知許可ダイアログの実装例

　Android & iOS のローカルプッシュ通知のパーミッション(許可)ダイアログを表示する実装例です。
この機能を実装することにより、端末でのローカルプッシュ通知の許可確認のダイアログを表示させることができます。
また、ダイアログ内で「許可」を押したら、以降は許可確認ダイアログを表示しない設計になっています。

環境

Unity 6000.3.x
Mobile Notifications 2.4.x

　外部ライブラリとして UniTask を利用しています。

UniTask 2.5.11

Mobile Notifications パッケージをインストールする

　Unity の PackageManager より Mobile Notifications をインストールします。

Unity 公式ドキュメント
Mobile Notifications package
https://docs.unity.cn/Packages/com.unity.mobile.no...

　利用しているバージョンは 2.4.x 系です。

Android

　Android 13以上では、POST_NOTIFICATIONS 権限をユーザーに要求する必要があります。

　PermissionStatus は Moble Notifications パッケージで用意されている enum です。
こちらの情報を利用してローカルプッシュ通知の実装を行っています。

Moble Notifications の機能を利用するには using Unity.Notifications.Android の宣言が必要です。

　ソースコードは Mobile Notifications 2.4.xの内容で記載しています(古いバージョンですと API などが異なります)。

　ダイアログ内で「許可」を押したら、以降は許可確認ダイアログを表示しない設計になっています。

NotificationPermissionManager.cs

using Cysharp.Threading.Tasks;
using System.Threading;

#if UNITY_ANDROID
using Unity.Notifications.Android;
#endif

public static class NotificationPermissionManager
{
    public static async UniTask<PermissionStatus> RequestPermissionAsync(CancellationToken token = default)
    {
#if UNITY_EDITOR

        await UniTask.Yield(cancellationToken: token);
        return PermissionStatus.Allowed;

#elif UNITY_ANDROID

        PermissionStatus status = AndroidNotificationCenter.UserPermissionToPost;

        switch (status)
        {
            case PermissionStatus.Allowed:
                return PermissionStatus.Allowed;

            case PermissionStatus.Denied:
            case PermissionStatus.DeniedDontAskAgain:
                return status;

            case PermissionStatus.RequestPending:
                while (AndroidNotificationCenter.UserPermissionToPost == PermissionStatus.RequestPending)
                {
                    token.ThrowIfCancellationRequested();
                    await UniTask.Yield(PlayerLoopTiming.Update, token);
                }

                return AndroidNotificationCenter.UserPermissionToPost;

            case PermissionStatus.NotRequested:
                PermissionRequest request = new PermissionRequest();

                while (request.Status == PermissionStatus.RequestPending)
                {
                    token.ThrowIfCancellationRequested();
                    await UniTask.Yield(PlayerLoopTiming.Update, token);
                }

                return request.Status;
        }

        return status;

#else

        return PermissionStatus.Allowed;

#endif
    }
}

　実行側の実装例です。

PermissionStatus status = await NotificationPermissionManager.RequestPermissionAsync();

switch (status)
{
    case PermissionStatus.Allowed:
        Debug.Log("通知許可済み");
        break;

    case PermissionStatus.Denied:
        Debug.Log("通知拒否");
        break;

    case PermissionStatus.DeniedDontAskAgain:
        Debug.Log("設定変更が必要");
        break;
}

iOS の場合

　Project Settings 内の Mobile Notifications を選択し、iOS タブを選択します。
こちらにある Request Authorization on App Launch を ON にします。

　この設定をONにすると、アプリ起動時にUnityが自動で UNUserNotificationCenter へ通知権限を要求してくれます。

　つまり Android とは異なり、ソースコードによるパーミッションの実行処理は不要です。

　Request Authorization on App Launch を OFF にした場合には、Android のようにソースコードでの実行が必要になります。

ローカルプッシュ通知の許可通知ダイアログ表示の実装のタイミングについて

　ゲーム開始直後に「通知を許可しますか？」と突然出ると、かなりの割合で「許可しない」が押されます。
これはユーザーとしてみれば当然の判断であり、基本的に、どのようなローカル通知が来るのかわからない状態で「許可する」ことはあまりないでしょう。

　最近のゲームは

ゲーム開始
    ↓
チュートリアル
    ↓
ゲーム内のイベント　→　「スタミナ回復を通知できます」「無料のガチャが引けるようになったら通知できます」
    ↓
通知許可ダイアログ

　という流れが一般的かと思われます。
どういった内容の通知がくるのかわかってからの方が通知の許可率がかなり高くなります。

　自分が１ユーザーである目線を大事にして、実装するタイミングを検討してみましょう。

このページを編集するこのページを元に新規ページを作成

印刷する

コメント（0）

Mobile Notifications を利用したローカルプッシュ通知許可ダイアログの実装例 - i-school 先頭へ

コメントをかく

名前	ユーザIDを使用しないで書き込む	ユーザーIDを使う	ログインする
画像コード	画像に記載されている文字を下のフォームに入力してください。
備考	「http://」を含む投稿は禁止されています。
本文
利用規約をご確認のうえご記入下さい

i-school