【Unity】Package Managerにモバイル通知の機能が追加されていた件(2)
本記事で扱うUnityのバージョンは「Unity2018.3.7f1」です。
前回
sunagimo-app.hatenablog.com
本日はAPIを見ていきます。
https://docs.unity3d.com/Packages/com.unity.mobile.notifications@1.0/manual/index.html
まずAPIを使用する前に、Android、iOSで宣言が必要。
using Unity.Notifications.Android; using Unity.Notifications.iOS;
Android
AndroidNotification
指定できるパラメーターは、以下。
・Color(通知テンプレートの色?っぽい)
・FireTime(通知をする時間)
・LargeIcon(通知の大きいアイコン、/Assets/Plugins/Android/res/drawableに置く)
・Number(バッジの数)
・RepeatInterval (繰り返し間隔)
・ShouldAutoCancel(ユーザーが触れると自動的に消去される?よくわからない)
・SmallIcon(通知の小さいアイコン、大きいアイコンと同じ場所に入れておく)
・Style(通知のカスタムスタイル)
・Text(通知の本文)
・Title (通知のタイトル)
・UsesStopwatch (通知時刻フィールドをタイムスタンプではなく、ストップウォッチとして表示するか。よくわからない)
iOS
iOSNotification
指定できるパラメーターは、以下。
・Badge(バッジの数)
・Body(通知の本文)
・CategoryIdentifier(カテゴリ識別子)
・ForegroundPresentationOption(アプリの実行中に通知の地域を表示するための表示オプション?よくわからない)
・Identifier(識別子)
・ShowInForeground(アプリが起動中に通知アラートを表示するか)
・Subtitle(サブタイトル)
・ThreadIdentifier(宣言?よくわからない)
・Title(タイトル)
・Trigger(通知の配信をトリガーする条件、ここで通知時間も設定するらしい)
Android
SendNotification作成したAndroidNotificationとチャンネル名を引数に渡します。
返ってくるIDは後々更新する際に使用可能。
iOS
ScheduleNotification作成したiOSNotificationを引数として渡します。
Android
(通知の削除)CancelScheduledNotification
通知を送った際のIdを引数に渡します。
(通知の全削除)
CancelAllScheduledNotifications
iOS
(通知の削除)RemoveScheduledNotification
作成した際の識別子を引数として渡します。
(通知の全削除)
RemoveAllScheduledNotifications
Android
CheckScheduledNotificationStatusAPI23(Android OS6.0)より使用可能。
通知を送る際のIdを引数に渡します。
iOS
GetScheduledNotificationsAndroidとは異なり、スケジュールされている通知の情報がすべて返ってきます。
モバイル通知を実装するにあたって、基本的に必要なものをまとめてみました。
それと、最後に記事を書いてて思ったのですが、
iOSの通知にはすでに、NotificationServicesというAPIが用意されています。
docs.unity3d.com
これから両方生き残るということはないかと思いますが、
どちらが死にどちらかが生き残るのかと。
公式からはおそらく何も来ていないのでどうなるのでしょうかね…
次回は、実際にソースコードを書いて、
コードやデモの紹介もしていきます。
【Unity】Package Managerにモバイル通知の機能が追加されていた件(1)
本記事で扱うUnityのバージョンは「Unity2018.3.7f1」です。
Unity2018.2頃からPackage Managerに追加されていました。
現在はVersion 1.0.0とのこと。
変更ログみると結構頻繁に更新が行われてそうな感じ…
これは期待できそう!!
Changelog | Package Manager UI website
ドキュメントにもありますが、
簡単に概要をまとめてみました。
Unity Mobile Notifications Package | Package Manager UI website
【機能】
・リピート通知
・単発通知
・通知の削除
・Android Oreo以上で通知のカテゴリ化
・カスタム通知アイコン(これはAndroidだけかな?iOSはPlayerSettingsに設定できるところがあるので)
・iOS12以降で通知のグループ化
【必要条件】
・Android4.1以上
・iOS10以上
・Unity2018.2以降
OSのバージョンはどうだろうか…
<Android>
2018年10月26日現在
https://developer.android.com/about/dashboards/index.html
4.1以降は99.5%とのことなので十分です。
<iOS>
2019年2月24日現在
https://developer.apple.com/support/app-store/
iOS10以降は90%以上を超えているので十分です。
十分すぎるくらい必要条件を満たしています。
今日はざっくりこんな感じです。
明日は実際にAPIの中身を見ていきます。
(1)概要 ←今回
(2)APIの中身をみる ←明日(2/26)
(3)サンプルを作成 ←明後日ぐらい?