サイトアイコン Embarcadero RAD Studio, Delphi, & C++Builder Blogs

RAD Studio 10.4.1で変更されたiOSアプリの通知機能

Embarcadero Japan Support

このブログでは、10.4.1で変更されたiOSの通知機能に関してチュートリアルを交えて解説いたします。

はじめに

10.4.1よりも前のバージョン(10.4.0も含む)では、iOSアプリの通知機能は、docwikiの「モバイル チュートリアル：通知を使用する（iOS および Android）」に記載されている方法で利用することができました。

例えば、iOSアプリの通知機能を利用する簡単な手順は以下の通りです。

  1. フォーム上にTNotificationCenterコンポーネントを配置
  2. プロジェクト」→「オプション」→「バージョン情報」からFMLocalNotificationPermissionの値をtrueに設定
  3. iOS上でTNotificationCenter.PresentNotificationを実行

しかしながら、10.4.1で同じ手順で通知機能を実装すると、下図のようなエラーが表示されます。

それでは10.4.1で、iOSの通知機能を利用するためには、どうすれば良いのでしょうか。

10.4.1で提供している以下のサンプルプログラムでは、

C:¥Users¥Public¥Documents¥EmbarcaderoStudio¥21.0¥Samples¥Object Pascal¥Mobile¥ Snippets¥Notifications¥SendCancelNotification

実装例が示されていますが、現在のdocwikiでは詳しい解説はありません。

最近、RAD Studio(Delphi/C++Builder)をご利用のお客様からエンバカデロのサポートセンターへ同様なお問い合わせが増えているため、このブログで変更点や実際の使い方も含めまして補足させていただきます。

10.4.1での変更点

上述しましたが、10.4.1よりも前のバージョンで iOSの通知機能を利用する場合は、プロジェクトのバージョン情報で”FMLocalNotificationPermission”の値をtrueに設定する必要がありました。

FMLocalNotificationPermission”の値は、FMX.Platfomr.iOSユニットのTApplicationDelegate.CheckLocalNotificationPermissionメソッドでチェックし、iOS 8以上、かつtrueの場合は、iOSのapiであるUIUserNotificationSettingsを内部で実行してiOSの通知認証を行っていました。

しかしながらiOS 10以降では、UIUserNotificationSettingsの利用は非推奨となっており、10.4.1以降では、iOS10以降で推奨されるUNUserNotificationCenterを利用するように変更されました。

なお、この変更に伴いましてFMLocalNotificationPermissionの項目は廃止されています。10.4.1のプロジェクトのバージョン情報から削除されており、もし手動でこの項目も追加しても無効になっていますので、ご注意ください。

10.4.1では、新たにTNotificationCenterコンポーネントにOnPermissionRequestResultイベントが追加されました。

OnPermissionRequestResultイベントは、RequestPermissionメソッドを実行し、通知を操作するためのアクセス許可を非同期的に要求した後、許可要求の結果を受信するためのイベントです。RequestPermissionメソッドを実行すると、下図のように通知の認証ダイアログが表示されます。

つまり、このダイアログの許可/不許可の結果が、OnPermissionRequestResultイベントで取得できます。

そのため10.4.1以降でiOSの通知機能を利用するためには、RequestPermissionメソッドを呼び出す処理と、OnPermissionRequestResultイベントで通知の認証結果を判断する処理の実装が必要となります。

チュートリアル: 10.4.1でのiOSアプリの通知機能の実装

以下は、Delphi/C++BuilderでiOS通知を行うための簡単な実装手順となります。

(1)10.4.1で新規にマルチデバイスプロジェクトを作成

(2)フォーム上にTNotificationCenterとTButtonを一つずつ配置

(3)通知許可フラグを実装する

あとでOnPermissionRequestResultイベント内で通知の認証結果の判断を行うためのNotification_Permission_Flagフラグを実装します。

Delphiの場合:

[crayon-676866efa9877867663587/]

C++Builderの場合:

[crayon-676866efa9881871100295/]

(4)通知許可を要求するための処理を実装する

通知許可を要求する処理は、通知を実行する前であれば、どのタイミングでも構いません。ここでは、フォームが表示されるOnActivateイベントで実装します。フォームのOnActivateイベントで以下の処理を追加してください。

Delphiの場合:

[crayon-676866efa9882239555250/]

C++Builderの場合:

[crayon-676866efa9885607274386/]

TAuthorizationStatusには、NotDetermined, Restricted, Denied, Authorizedの4種類があります。ここでは、Authorized(認証)されていないときに、通知許可を要求(RequestPermission)を実行します。

(5)通知の許可要求の結果を受信するためのイベントを実装する

TNotificationCenterのOnPermissionRequestResultイベントで、以下の処理を追加してください。

Delphiの場合:

[crayon-676866efa9886629432364/]

C++Builderの場合:

[crayon-676866efa9887194760075/]

AIsGrantedの値は、通知ダイアログの結果が渡されます。Trueの場合は許可、Falseの場合は拒否

(6)通知処理を実装する

TButtonのOnClickイベントで、以下の処理を追加してください。

Delphiの場合:

[crayon-676866efa9888200181025/]

C++Builderの場合:

[crayon-676866efa9889255412913/]

(7)ターゲットプラットホームを”iOSデバイス 64ビット”に切り替えてビルドし、iOSデバイスへ配置する

※プロジェクトの[バージョン情報]で、iOS通知に関する項目の変更は特に必要ありません。

下図は、iOSデバイスでの実行例です。

iOS 14 SDK(Xcode 12)を利用する上での注意点

C++Builder/Delphiで、iOS 14 SDK(Xcode 12)をインポートして利用する場合は、以下の注意が必要です。

まとめ

10.4.1では、iOS通知機能に関して以下の変更が行われました。

  1. FMLocalNotificationPermissionの廃止
  2. 非推奨であるUIUserNotificationSettingsからUNUserNotificationCenterへ置き換え
  3. TNotificationCenterコンポーネントにOnPermissionRequestResultイベントを追加

これによってお客様のプログラム側でRequestPermissionメソッドを呼び出す処理と、OnPermissionRequestResultイベントで通知の認証結果を判断する処理の実装が必要となりました。

上記の修正を行う手間がかかるようになりましたが、これによって最新のiOS 14でも動作し、以前のバージョンより適切にiOS通知機能が利用できます。

10.4.1よりも前のバージョンを利用しているお客様はどうかご留意ください。

モバイルバージョンを終了