クイックスターターズ
tvOSのバックエンドを構築する方法は？

40min
はじめに
このチュートリアルでは、 tvOS アプリのバックエンドを Back4App を使用して構築する方法を学びます。
データベース管理、Cloud Code Functions、REST および GraphQL API、ユーザー認証、リアルタイム（ライブクエリ）など、Back4App の重要な機能を統合して、あなたの Apple TV アプリとシームレスに通信する安全でスケーラブルなバックエンドを作成します。
Back4App の効率的な環境と迅速なセットアップにより、サーバーやデータベースを手動で構成するのに比べて、時間が大幅に短縮されることがわかります。
その過程で、先進的なセキュリティ機能、クラウドジョブのスケジューリング、Webhook 統合など、主要な機能を実際に体験します。
このチュートリアルの終わりまでには、この基盤構造を生産準備が整った tvOS アプリに拡張したり、カスタムロジックやサードパーティの API を簡単に組み込む準備が整います。このガイドは、あなたの 高品質 なユーザー体験を Apple TV で維持するのにも役立ちます。あなたの Xcode プロジェクト と既存の iOS 開発 知識を活用してください。
前提条件
このチュートリアルを完了するには、次のものが必要です:
Back4App アカウントと新しい Back4App プロジェクト
Back4app の始め方
アカウントを持っていない場合は、無料で作成できます。上記のガイドに従ってプロジェクトを準備してください。
Xcode（最新の安定版）をインストール済み
あなたは tvOS アプリ を Swift または SwiftUI で構築します。Mac App Store から最新の Xcode を入手してください。
Parse Swift SDK
あなたの tvOS アプリを接続するために Parse Swift SDK を設定してください。
Swift と基本的な iOS/tvOS 開発の概念に精通していること
Apple TV に不慣れな場合は、まず Apple tvOS ドキュメント または初心者向けのチュートリアルを確認してください。
始める前に、これらの前提条件がすべて整っていることを確認してください。Back4Appプロジェクトを準備し、ローカルのtvOS Xcodeプロジェクトを設定することで、より簡単に進めることができます。
ステップ1 – Back4Appで新しいプロジェクトを作成し接続する
新しいプロジェクトを作成する
Back4Appでの tvOSアプリのバックエンドを構築する最初のステップは、新しいプロジェクトを作成することです。まだ行っていない場合は、次の手順に従ってください:
Back4Appアカウントにログインする.
Back4Appダッシュボードの「新しいアプリ」ボタンをクリックする.
アプリに名前を付ける（例：「tvOS-バックエンド-チュートリアル」）。
﻿
作成が完了すると、Back4Appダッシュボードにプロジェクトが表示されます。この新しいBack4Appプロジェクトは、このチュートリアルでカバーされるすべてのバックエンド設定の中心です。
Parse Swift SDKを接続する
Back4Appは Parse を利用してデータストレージ、ユーザー認証、リアルタイム機能などを処理します。あなたの tvOSアプリ をBack4Appに接続するには、あなたの Xcodeプロジェクト にParse Swift SDKをインストールして設定します。
あなたのParseキーを取得する:
あなたのBack4Appダッシュボードで、「アプリ設定」または「セキュリティとキー」に移動して、あなたの アプリケーションID と クライアントキー を見つけてください。また、 ParseサーバーURL も表示されます—一般的には https://parseapi.back4app.com です。
﻿
Parse Swift SDKをインストールする あなたのtvOSプロジェクトに:
Swiftパッケージマネージャー（推奨）
Xcodeで、 ファイル → パッケージを追加 を選択します。
Parse SwiftのGitHub URLを入力します: https://github.com/netreconlab/Parse-Swift.git
適切なバージョンまたはメインブランチを選択します。
CocoaPods
CocoaPodsを好む場合は、次の内容をPodfileに追加します:
Ruby
pod 'ParseSwiftOG'
pod 'ParseSwiftOG'
﻿
次に pod install を実行します。
Parseを初期化するには、あなたの AppDelegate または @main 構造体で:
Swift
import ParseSwift
import SwiftUI

@main
struct MyTVOSApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY", 
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \\(error)")
            }
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
import ParseSwift
import SwiftUI

@main
struct MyTVOSApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY", 
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \\(error)")
            }
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
﻿
これにより、あなたの tvOSアプリ がBack4Appバックエンドと通信できるようになり、データを保存したり、クエリを実行したり、ユーザーを認証したり、その他の操作が可能になります。
ステップ2 – データベースの設定
データモデルの作成
あなたのtvOSアプリがBack4Appに接続されたので、データを作成および管理できます。Parse Swiftでは、 ParseObject 構造体を定義します:
Swift
struct GameScore: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Custom fields
    var score: Int?
    var playerName: String?
}
struct GameScore: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Custom fields
    var score: Int?
    var playerName: String?
}
﻿
Back4Appダッシュボードでクラスを手動で定義することもできます:
「データベース」に移動 Back4Appコンソールで。
新しいクラスを作成（例:「GameScore」）。
関連するカラムを追加（スコア、プレイヤー名など）。
新しいクラスを作成
﻿
AIエージェントを使用したデータモデルの作成
Back4AppのAIエージェントは、スキーマを自動的に設計できます:
AIエージェントを開く Back4Appダッシュボードで。
モデルを説明する（例:「タイトルとisCompletedフィールドを持つToDoクラスを作成」）。
適用する そしてAIエージェントにスキーマを生成させる。
﻿
SDKを使用したデータの読み書き
Swift
func saveScore() async {
    var gameScore = GameScore()
    gameScore.score = 1337
    gameScore.playerName = "tvOS Fan"
    do {
        try await gameScore.save()
        print("Score saved successfully.")
    } catch {
        print("Error saving score: \\(error)")
    }
}

func fetchScores() async {
    let query = GameScore.query()
    do {
        let results = try await query.find()
        print("Fetched scores: \\(results)")
    } catch {
        print("Error fetching scores: \\(error)")
    }
}
func saveScore() async {
    var gameScore = GameScore()
    gameScore.score = 1337
    gameScore.playerName = "tvOS Fan"
    do {
        try await gameScore.save()
        print("Score saved successfully.")
    } catch {
        print("Error saving score: \\(error)")
    }
}

func fetchScores() async {
    let query = GameScore.query()
    do {
        let results = try await query.find()
        print("Fetched scores: \\(results)")
    } catch {
        print("Error fetching scores: \\(error)")
    }
}
﻿
REST APIを使用したデータの読み書き
Bash
curl -X POST \ 
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score": 9000, "playerName": "AppleFan"}' \
  https://parseapi.back4app.com/classes/GameScore
curl -X POST \ 
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score": 9000, "playerName": "AppleFan"}' \
  https://parseapi.back4app.com/classes/GameScore
﻿
GraphQL APIを使用したデータの読み書き
GraphQL
mutation {
  createGameScore(input: {
    fields: {
      score: 420
      playerName: "Swiftie"
    }
  }) {
    gameScore {
      objectId
      score
      playerName
    }
  }
}
mutation {
  createGameScore(input: {
    fields: {
      score: 420
      playerName: "Swiftie"
    }
  }) {
    gameScore {
      objectId
      score
      playerName
    }
  }
}
﻿
ライブクエリを使用する（オプション）
ライブクエリは、あなたの Apple TV インターフェースでリアルタイムの更新を可能にします—特にマルチプレイヤーやリーダーボードアプリに便利です。
ライブクエリを有効にする あなたのアプリの サーバー設定 をBack4Appで。
サブスクリプションを初期化する:
Swift
let subscription = GameScore.query("score" > 1000).subscribeCallback { event in
    switch event {
    case .created(let score):
        print("New high score created: \\(score)")
    case .updated(let score):
        print("High score updated: \\(score)")
    case .deleted(let score):
        print("High score removed: \\(score)")
    default:
        break
    }
}
let subscription = GameScore.query("score" > 1000).subscribeCallback { event in
    switch event {
    case .created(let score):
        print("New high score created: \\(score)")
    case .updated(let score):
        print("High score updated: \\(score)")
    case .deleted(let score):
        print("High score removed: \\(score)")
    default:
        break
    }
}
﻿
ステップ 3 – ACL と CLP を使用したセキュリティの適用
概要
Back4App は、ACLs（アクセス制御リスト）とCLPs（クラスレベルの権限）を使用してデータを保護します。オブジェクトまたはクラスレベルでの読み取り/書き込みルールを定義するために使用します。
﻿
クラスレベルの権限
データベースに移動, クラスを選択します（例: GameScore）。
「セキュリティ」をクリック または「クラスレベルの権限」をクリックします。
誰が読み取り、書き込み、または削除できるかを設定（例: 認証されたユーザーのみ）。
コード内の ACLs
Swift
var gameScore = GameScore()
gameScore.score = 500
// Restrict read/write to only the current user
var acl = ParseACL()
if let user = try? await User.current() {
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)
}
gameScore.ACL = acl
var gameScore = GameScore()
gameScore.score = 500
// Restrict read/write to only the current user
var acl = ParseACL()
if let user = try? await User.current() {
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)
}
gameScore.ACL = acl
﻿
ステップ 4 – クラウドコード関数の作成
なぜクラウドコードなのか？
クラウドコードを使用すると、クライアントから重要なロジックを安全なサーバーサイドコードにオフロードできます。これは、ビジネスルール、データ検証、またはtvOSアプリ内の秘密を公開せずに行うサードパーティ統合に最適です。
例の関数
あなたの main.js:
JS
Parse.Cloud.define("awardBonus", async (request) => {
  const { objectId, bonus } = request.params;
  const query = new Parse.Query("GameScore");
  const gameScore = await query.get(objectId, { useMasterKey: true });
  gameScore.increment("score", bonus);
  await gameScore.save(null, { useMasterKey: true });
  return gameScore;
});
Parse.Cloud.define("awardBonus", async (request) => {
  const { objectId, bonus } = request.params;
  const query = new Parse.Query("GameScore");
  const gameScore = await query.get(objectId, { useMasterKey: true });
  gameScore.increment("score", bonus);
  await gameScore.save(null, { useMasterKey: true });
  return gameScore;
});
﻿
デプロイメント
Back4App CLI:
Bash
b4a configure accountkey
b4a deploy
b4a configure accountkey
b4a deploy
﻿
または Back4App Dashboard → Cloud Code → Functions → main.js.
Swiftからの呼び出し
Swift
import ParseSwift

func awardBonusScore(objectId: String, bonus: Int) async {
    do {
       let result = try await ParseCloud.callFunction("awardBonus", with: [
         "objectId": objectId,
         "bonus": bonus
       ])
       print("Updated score: \\(result)")
    } catch {
       print("Error awarding bonus: \\(error)")
    }
}
import ParseSwift

func awardBonusScore(objectId: String, bonus: Int) async {
    do {
       let result = try await ParseCloud.callFunction("awardBonus", with: [
         "objectId": objectId,
         "bonus": bonus
       ])
       print("Updated score: \\(result)")
    } catch {
       print("Error awarding bonus: \\(error)")
    }
}
﻿
NPMモジュール
あなたの package.json, 依存関係を追加します:
JSON
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
﻿
次に、Cloud Codeで使用するために main.js に要求またはインポートします。
ステップ5 – 認証の設定
Back4Appでのユーザー認証
tvOSアプリは、ユーザーデータの同期やログインが必要なことがよくあります。Parseの ParseUser は、安全なサインアップ、ログイン、セッション、およびロールベースのアクセスを提供します。
Swift
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Essential
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String: [String: String]?]?
}
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Essential
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String: [String: String]?]?
}
﻿
サインアップ / ログイン
Swift
func signUpUser() async {
    var newUser = User()
    newUser.username = "tvUser"
    newUser.password = "secret"
    newUser.email = "[email protected]"
    do {
        try await newUser.signUp()
        print("Sign-up successful.")
    } catch {
        print("Error signing up: \\(error)")
    }
}

func loginUser() async {
    do {
        let loggedIn = try await User.login(username: "tvUser", password: "secret")
        print("Logged in as: \\(loggedIn.username ?? "")")
    } catch {
        print("Login error: \\(error)")
    }
}
func signUpUser() async {
    var newUser = User()
    newUser.username = "tvUser"
    newUser.password = "secret"
    newUser.email = "user@example.com"
    do {
        try await newUser.signUp()
        print("Sign-up successful.")
    } catch {
        print("Error signing up: \\(error)")
    }
}

func loginUser() async {
    do {
        let loggedIn = try await User.login(username: "tvUser", password: "secret")
        print("Logged in as: \\(loggedIn.username ?? "")")
    } catch {
        print("Login error: \\(error)")
    }
}
﻿
ソーシャルログイン
設定する FacebookまたはAppleサインイン。次に、アカウントをリンクします:
Swift
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
﻿
ステップ6 – ファイルストレージの取り扱い
ファイルストレージの設定
ユーザー画像、ゲームリプレイ、またはアプリ資産を ParseFile:
Swift
let fileData = Data(...) // e.g. image bytes
let file = ParseFile(name: "preview.png", data: fileData)
do {
    let savedFile = try await file.save()
    print("File uploaded: \\(savedFile.url)")
} catch {
    print("Error uploading file: \\(error)")
}
let fileData = Data(...) // e.g. image bytes
let file = ParseFile(name: "preview.png", data: fileData)
do {
    let savedFile = try await file.save()
    print("File uploaded: \\(savedFile.url)")
} catch {
    print("Error uploading file: \\(error)")
}
﻿
例
オブジェクトにファイルを添付します:
Swift
struct GameMedia: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var screenshot: ParseFile?
}
struct GameMedia: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var screenshot: ParseFile?
}
﻿
セキュリティの考慮事項
ファイル参照を保護するためにCLPまたはACLを使用します。ファイルの直接URLは、ファイルセキュリティを有効にしない限り、公開アクセス可能です。
ステップ7 – メール確認とパスワードリセット
概要
メール確認は、ユーザーのメールアカウントの所有権を確認するのに役立ちます。パスワードリセットは、アカウントアクセスを回復するための安全でユーザーフレンドリーな方法を提供します。
Back4Appダッシュボードの設定
アプリ内で → アプリ設定 → メール
メール確認またはパスワードリセットを有効にします。
メールテンプレートをカスタマイズします。
コード実装
Swift
func requestPasswordReset(for email: String) async {
    do {
        try await User.passwordReset(email: email)
        print("Password reset link sent.")
    } catch {
        print("Error requesting password reset: \\(error)")
    }
}
func requestPasswordReset(for email: String) async {
    do {
        try await User.passwordReset(email: email)
        print("Password reset link sent.")
    } catch {
        print("Error requesting password reset: \\(error)")
    }
}
﻿
ステップ8 – クラウドジョブによるタスクのスケジューリング
クラウドジョブ
古いデータのクリーンアップや月次更新のメール送信など、定期的なタスクを自動化します:
JS
Parse.Cloud.job("cleanupOldScores", async (request) => {
  const now = new Date();
  const thirtyDaysAgo = new Date(now - 30 * 24 * 60 * 60 * 1000);
  const query = new Parse.Query("GameScore");
  query.lessThan("createdAt", thirtyDaysAgo);
  const oldScores = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldScores, { useMasterKey: true });
  return `Deleted ${oldScores.length} old scores.`;
});
Parse.Cloud.job("cleanupOldScores", async (request) => {
  const now = new Date();
  const thirtyDaysAgo = new Date(now - 30 * 24 * 60 * 60 * 1000);
  const query = new Parse.Query("GameScore");
  query.lessThan("createdAt", thirtyDaysAgo);
  const oldScores = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldScores, { useMasterKey: true });
  return `Deleted ${oldScores.length} old scores.`;
});
﻿
「Back4Appダッシュボード → アプリ設定 → サーバー設定 → バックグラウンドジョブ」で、「cleanupOldScores」を毎日実行するようにスケジュールします。
クラウドジョブのスケジューリング
﻿
ステップ9 – ウェブフックの統合
定義
ウェブフックは、Back4Appアプリが外部サービスにイベントを送信できるようにします。これには、Slackへの通知、Stripeへの支払い更新、またはサーバーへの分析データの送信が含まれます。
設定
Back4Appダッシュボードで、「その他 → ウェブフック → ウェブフックを追加」に進みます。エンドポイント（例えば、「https://myserver.com/webhook-endpoint」）とトリガー（オブジェクトの更新、新しいレコードなど）を指定します。
ウェブフックの追加
﻿
例
新しいハイスコアが作成されたときにSlackに通知します:
JS
Parse.Cloud.afterSave("GameScore", async (request) => {
  const score = request.object.get("score");
  await sendToSlack(`A new high score of ${score} was posted!`);
});
Parse.Cloud.afterSave("GameScore", async (request) => {
  const score = request.object.get("score");
  await sendToSlack(`A new high score of ${score} was posted!`);
});
﻿
ステップ 10 – Back4App 管理パネルの探索
どこで見つけるか
「Back4App 管理アプリ」は、データを管理し、CRUDを実行し、クラスを編集するためのユーザーフレンドリーで、モデル中心のダッシュボードです。直接データベースクエリを必要とせずに操作できます。
「アプリダッシュボード」 → 「その他」 → 「管理アプリ」を介して有効にします。
管理アプリを有効にする
﻿
機能
有効にすると、チームメンバーやクライアントを招待してデータを管理したり、ログを確認したり、プッシュ通知を調整したりできます。基本的に、あなたのtvOSアプリのバックエンドへの直接ポータルを提供します。
結論
この包括的なチュートリアルに従うことで、あなたは:
安全なバックエンドを作成しました あなたの tvOS アプリのために Back4App を使用して。
データベースを構成しました クラス、データ型、関係を持つ。
リアルタイムクエリを設定しました 即時の変更を反映するために。
ACL と CLP を通じてセキュリティを適用しました
カスタムビジネスロジックと統合のために Cloud Code を実装しました
メール確認とパスワードリセットを通じて認証を有効にしました
オプションのセキュリティコントロールを持つファイルアップロードを処理しました
定期的なタスクのために Cloud Jobs をスケジュールしました
外部サービスと統合するためにウェブフックを使用しました
データを管理および監視するために管理パネルを探索しました
あなたは今、リッチで 高品質な Apple TV 経験を構築するための十分な準備が整いました。あなたの アプリは構築されました 強固な基盤の上に—あなたの tvOS アプリ のアイデアを現実にすることを楽しんでください！
次のステップ
tvOS UIを洗練させる: フォーカスベースのナビゲーション、大画面ユーザーフロー、そして App Store のベストプラクティスを取り入れましょう。
セキュリティを強化する: ロールベースのACL、マルチファクター認証、または高度な暗号化を追加しましょう。
スキルセットを深める: オフラインキャッシングやカスタム分析など、より高度なParse Swift機能を探求しましょう。
公式ドキュメントを確認する: Back4Appドキュメント と Apple tvOSドキュメント を参照して、より深い知識を得ましょう。
マネタイズ: サブスクリプションやペイパービューを検討して、ストリーミングビジネスの可能性を広げましょう。
このガイドの基本をもとに、革新を続け、新しい機能を統合できます。あなたの tvOSアプリ を次のレベルに引き上げることを願っています！
更新日 24 Jan 2025
このページは役に立ちましたか？
WatchOSのためのバックエンドを構築する方法は？
MacOS用のバックエンドの構築方法は？