XCode 12.4 日本語化計画：Swift Tutorials

セクション 5

カスタム通知インターフェイスの作成




watchOS のランドマークのバージョンはほぼ完成しています。この最後のセクションでは、お気に入りの場所の 1 つに近いことを示す通知を受信する時はいつでも、ランドマーク情報を表示する通知インターフェースを作成します。




注意




このセクションでは、通知を受信した後に通知を表示する方法についてのみ説明します。通知を設定または送信する方法については説明していません。





ステップ 1

NotificationView.swift を開き、ランドマーク、タイトル、およびメッセージに関する情報を表示するビューを作成します。




---




通知の値は nil にすることができるため、プレビューには 2 つのバージョンの通知ビューが表示されます。1 つ目は、データが全く提供されていない場合のデフォルト値を表示し、2 つ目は、指定したタイトル、メッセージ、および場所を表示します。

























ステップ 2

NotificationController を開き、landmark,title, および message のプロパティを追加します。




---




これらのプロパティは着信の通知に関する値を格納します。

































ステップ 3

body() メソッドを更新してこれらのプロパティを使用します。




---




このメソッドは、以前に作成した通知ビューをインスタンス化します。







ステップ 4

LandmarkIndexKey を定義します。




---




このキーを使用して、通知からランドマークインデックスを抽出します。















ステップ 5

didReceive(_:) メソッドを更新して、通知からのデータを解析します。




---




このメソッドは、コントローラのプロパティを更新します。このメソッドを呼び出した後、システムはコントローラの body プロパティを無効にし、ナビゲーションビューを更新します。 その後、システムは Apple Watch に通知を表示します。












Apple Watch は通知を受信すると、通知のカテゴリに関連したアプリ内のシーンを探します。





ステップ 6

LandmarksApp.swift に移動し、LandmarkNear カテゴリを使用して WKNotificationScene を追加します。




---




シーンは watchOS でのみ意味があるため、条件付きコンパイルを追加します。





テストペイロードを構成して LandmarkNear カテゴリを使用し、通知コントローラが期待するデータを渡すようにします。





ステップ 7

PushNotificationPayload.apns ファイルを選択し、title、body、category、そして landmarkIndex のプロパティを更新します。category は必ず LandmarkNear に設定してください。また、Subtitle、WatchKit Simulator Actions、customKey など、チュートリアルで使用されていないキーはすべて削除します。




---




ペイロード (payload) ファイルは、リモート通知でサーバから送信されるデータをシミュレートします。



















ステップ 8

Landmarks-Watch (Notification) scheme (ランドマーク-ウォッチ (通知) スキーム) を選択し、アプリをビルドして実行します。




---




通知スキームを初めて実行すると、システムは通知を送信する許可を求めます。[Allow(許可)] を選択します。













































ステップ 9

権限を付与すると、シミュレータはスクロール可能な通知を表示し、これには、ランドマークアプリを送信者として識別するのに役立つアプリのアイコン、通知ビュー、通知のアクションのボタンが含まれます。

    NotificationView.swift

1. import SwiftUI
3. struct NotificationView: View {
var title: String?
var message: String?
var landmark: Landmark?
5. var body: some View {
VStack {
if landmark != nil {
CircleImage(image: landmark!.image.resizable())
.scaledToFit()
}
Text(title ?? "Unknown Landmark")
.font(.headline)
Divider()
Text(message ?? "You are within 5 miles of one of your favorite landmarks.")
.font(.caption)
}
.lineLimit(0)
6. }
7. }
9. struct NotificationView_Previews: PreviewProvider {
10. static var previews: some View {
Group {
NotificationView()
NotificationView(title: "Turtle Rock",
message: "You are within 5 miles of Turtle Rock.",
landmark: ModelData().landmarks[0])
}
11. }
12. }

プレビューその 1

    NotificationController.swift

1. import WatchKit
2. import SwiftUI
3. import UserNotifications
5. class NotificationController: WKUserNotificationHostingController<NotificationView> {
var landmark: Landmark?
var title: String?
var message: String?
7. override var body: NotificationView {
8. NotificationView()
9. }
11. override func willActivate() {
12. // This method is called when watch view controller is about to be visible to user
13. super.willActivate()
14. }
16. override func didDeactivate() {
17. // This method is called when watch view controller is no longer visible
18. super.didDeactivate()
19. }
21. override func didReceive(_ notification: UNNotification) {
22. // This method is called when a notification needs to be presented.
23. // Implement it if you use a dynamic notification interface.
24. // Populate your dynamic notification interface as quickly as possible.
25. }
26. }

    NotificationController.swift

10. override var body: NotificationView {
NotificationView(
title: title,
message: message,
landmark: landmark
)
11. }

    NotificationController.swift

7. var title: String?
8. var message: String?
let landmarkIndexKey = "landmarkIndex"
10. override var body: NotificationView {
11. NotificationView(

プログラム全体 その 1

    NotificationController.swift

30. override func didReceive(_ notification: UNNotification) {
let modelData = ModelData()
let notificationData =
notification.request.content.userInfo as? [String: Any]
let aps = notificationData?["aps"] as? [String: Any]
let alert = aps?["alert"] as? [String: Any]
title = alert?["title"] as? String
message = alert?["body"] as? String
if let index = notificationData?[landmarkIndexKey] as? Int {
landmark = modelData.landmarks[index]
}
31. }
32. }

プログラム全体 その 2

    LandmarksApp.swift

1. import SwiftUI
3. @main
4. struct LandmarksApp: App {
5. @StateObject private var modelData = ModelData()
7. var body: some Scene {
8. WindowGroup {
9. ContentView()
10. .environmentObject(modelData)
11. }
#if os(watchOS)
WKNotificationScene(controller: NotificationController.self, category: "LandmarkNear")
#endif
13. }
14. }

    PushNotificationPayload.apns

1. {
2. "aps": {
3. "alert": {
"title": "Silver Salmon Creek",
"body": "You are within 5 miles of Silver Salmon Creek."
4. },
"category": "LandmarkNear",
5. "thread-id": "5280"
6. },
"landmarkIndex": 1,
8. "WatchKit Simulator Actions": [
9. {
10. "title": "First Button",
11. "identifier": "firstButtonAction"
12. }
13. ],
15. "customKey": "Use this file to define a testing payload for your notifications. The aps dictionary specifies the category, alert text and title. The WatchKit Simulator Actions array can provide info for one or more action buttons in addition to the standard Dismiss button. Any other top level keys are custom payload. If you have multiple such JSON files in your project, you'll be able to select them when choosing to debug the notification interface of your Watch App."
16. }

次




macOS アプリの作成




watchOS 用の Landmarks アプリのバージョンを作成したら、Landmarks を Mac に導入するという、より大きな目標に目を向けましょう。これまでに学んだすべてに基づいて、iOS、watchOS、macOS 用の SwiftUI アプリをビルドした経験を締めくくります。




さあ始めましょう