Quickstarters
Comment construire un backend pour tvOS ?

42min
Introduction
Dans ce tutoriel, vous apprendrez comment construire un backend pour tvOS des applications en utilisant Back4App. 
Nous aborderons l'intégration des fonctionnalités essentielles de Back4App—comme la gestion de base de données, les fonctions Cloud Code, les API REST et GraphQL, l'authentification des utilisateurs, et les requêtes en temps réel (Live Queries)—pour créer un backend sécurisé et évolutif qui communique sans problème avec votre application Apple TV construite avec le SDK Parse Swift.
Vous verrez comment l'environnement rationalisé de Back4App et la configuration rapide réduisent considérablement le temps par rapport à la configuration manuelle des serveurs et des bases de données. 
En cours de route, vous acquerrez une expérience pratique avec des fonctionnalités clés, y compris des fonctionnalités de sécurité avancées, la planification de tâches cloud, et les intégrations de webhook.
À la fin de ce tutoriel, vous serez prêt à améliorer cette structure fondamentale en une application tvOS prête pour la production ou à inclure facilement une logique personnalisée et des API tierces. Ce guide vous aidera également à maintenir une expérience utilisateur de haute qualité sur Apple TV, en tirant parti de votre projet Xcode et de vos connaissances existantes en développement iOS.
Prérequis
Pour compléter ce tutoriel, vous aurez besoin de :
Un compte Back4App et un nouveau projet Back4App
Commencer avec Back4app.
Si vous n'avez pas de compte, vous pouvez en créer un gratuitement. Suivez le guide ci-dessus pour préparer votre projet.
Xcode (dernière version stable) installé
Vous construirez votre application tvOS avec Swift ou SwiftUI. Assurez-vous d'avoir la version la plus récente d'Xcode depuis le Mac App Store.
SDK Parse Swift
Configurez le SDK Parse Swift pour connecter votre application tvOS.
Familiarité avec Swift et les concepts de base du développement iOS/tvOS
Si vous êtes nouveau sur Apple TV, consultez la documentation Apple tvOS ou un tutoriel pour débutants d'abord.
Assurez-vous d'avoir tous ces prérequis en place avant de commencer. Avoir votre projet Back4App prêt et un projet Xcode tvOS configuré vous aidera à suivre plus facilement.
Étape 1 – Créer un nouveau projet sur Back4App et se connecter
Créer un nouveau projet
La première étape pour construire votre backend d'application tvOS sur Back4App est de créer un nouveau projet. Si vous ne l'avez pas encore fait, suivez ces étapes :
Connectez-vous à votre compte Back4App.
Cliquez sur le bouton “Nouvelle application” dans votre tableau de bord Back4App.
Donnez un nom à votre application (par exemple, “tvOS-Backend-Tutorial”).
﻿
Une fois créé, vous verrez le projet listé dans votre tableau de bord Back4App. Ce nouveau projet Back4App est le cœur de toutes les configurations backend couvertes dans ce tutoriel.
Connectez le SDK Parse Swift
Back4App utilise Parse pour gérer le stockage des données, l'authentification des utilisateurs, les fonctionnalités en temps réel, et plus encore. Pour connecter votre application tvOS à Back4App, installez et configurez le SDK Parse Swift dans votre projet Xcode.
Récupérez vos clés Parse:
Dans votre tableau de bord Back4App, allez dans “Paramètres de l'application” ou “Sécurité & Clés” pour trouver votre ID d'application et Clé client. Vous verrez également l'URL du serveur Parse—généralement https://parseapi.back4app.com.
﻿
Installez le SDK Parse Swift dans votre projet tvOS:
Gestionnaire de paquets Swift (Recommandé)
Dans Xcode, sélectionnez Fichier → Ajouter des paquets.
Entrez l'URL GitHub de Parse Swift : https://github.com/netreconlab/Parse-Swift.git
Choisissez la version appropriée ou la branche principale.
CocoaPods
Si vous préférez CocoaPods, ajoutez ce qui suit à votre Podfile:
Ruby
pod 'ParseSwiftOG'
pod 'ParseSwiftOG'
﻿
Ensuite, exécutez pod install.
Initialiser Parse dans votre AppDelegate ou @main struct:
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()
        }
    }
}
﻿
Cela garantit que votre application tvOS est construite pour communiquer avec le backend Back4App, vous permettant de stocker des données, d'exécuter des requêtes, d'authentifier des utilisateurs, et plus encore.
Étape 2 – Configuration de la base de données
Création d'un modèle de données
Avec votre application tvOS maintenant connectée à Back4App, vous pouvez créer et gérer des données. Dans Parse Swift, vous définissez ParseObject structs:
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?
}
﻿
Vous pouvez également définir manuellement des classes dans votre tableau de bord Back4App :
Allez à “Base de données” dans la console Back4App.
Créez une nouvelle classe (par exemple, “GameScore”).
Ajoutez des colonnes pertinentes (score, nomDuJoueur, etc.).
Créer une nouvelle classe
﻿
Créer un modèle de données en utilisant l'agent IA
L'agent IA de Back4App peut concevoir automatiquement votre schéma :
Ouvrez l'agent IA dans votre tableau de bord Back4App.
Décrivez votre modèle (par exemple, “Créer une classe ToDo avec un titre et un champ isCompleted”).
Appliquez et laissez l'agent IA générer le schéma.
﻿
Lire et écrire des données en utilisant le 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)")
    }
}
﻿
Lecture et écriture de données en utilisant l'API REST
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
﻿
Lecture et écriture de données en utilisant l'API GraphQL
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
    }
  }
}
﻿
Travailler avec des requêtes en direct (optionnel)
Les requêtes en direct peuvent alimenter des mises à jour en temps réel dans votre Apple TV interface—particulièrement utile pour les applications multijoueurs ou de classement.
Activer les requêtes en direct dans les Paramètres du serveur de votre application sur Back4App.
Initialiser une souscription :
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
    }
}
﻿
Étape 3 – Application de la sécurité avec les ACL et les CLP
Aperçu
Back4App sécurise vos données avec ACLs (Listes de Contrôle d'Accès) et CLPs (Permissions au Niveau de la Classe). Utilisez-les pour définir des règles de lecture/écriture au niveau de l'objet ou de la classe.
﻿
Permissions au Niveau de la Classe
Allez à la Base de Données, choisissez une classe (par exemple, GameScore).
Cliquez sur “Sécurité” ou “Permissions au Niveau de la Classe”.
Définissez qui peut lire, écrire ou supprimer (par exemple, uniquement les utilisateurs authentifiés).
ACL dans le Code
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
﻿
Étape 4 – Écriture des fonctions Cloud Code
Pourquoi Cloud Code ?
Le Cloud Code vous permet de décharger une logique critique de votre client vers un code sécurisé côté serveur. C'est idéal pour les règles commerciales, les validations de données ou les intégrations tierces sans exposer de secrets dans votre application tvOS.
Exemple de fonction
Dans votre 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;
});
﻿
Déploiement
Back4App CLI:
Bash
b4a configure accountkey
b4a deploy
b4a configure accountkey
b4a deploy
﻿
ou utilisez le Back4App Dashboard → Cloud Code → Functions → main.js.
Appel depuis 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)")
    }
}
﻿
Modules NPM
Dans votre package.json, ajoutez des dépendances :
JSON
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
﻿
Ensuite, exigez ou importez-les dans main.js pour les utiliser dans Cloud Code.
Étape 5 – Configuration de l'authentification
Authentification des utilisateurs dans Back4App
Les applications tvOS ont souvent besoin de synchronisation des données utilisateur ou de connexion. Le ParseUser de Parse fournit une inscription sécurisée, une connexion, des sessions et un accès basé sur les rôles.
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]?]?
}
﻿
Inscription / Connexion
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)")
    }
}
﻿
Connexion sociale
Configurer Connexion Facebook ou Apple. Ensuite, liez les comptes :
Swift
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
﻿
Étape 6 – Gestion du stockage de fichiers
Configuration du stockage de fichiers
Téléchargez des images utilisateur, des replays de jeux ou des ressources d'application en utilisant 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)")
}
﻿
Exemple
Attachez des fichiers aux objets :
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?
}
﻿
Considérations de sécurité
Utilisez des CLP ou des ACL pour sécuriser les références de fichiers. L'URL directe d'un fichier peut être accessible au public à moins que vous n'activiez Sécurité des fichiers.
Étape 7 – Vérification par e-mail et réinitialisation du mot de passe
Aperçu
La vérification par e-mail aide à confirmer la propriété des comptes de messagerie par les utilisateurs. La réinitialisation du mot de passe offre un moyen sécurisé et convivial de retrouver l'accès au compte.
Configuration du tableau de bord Back4App
Dans votre application → Paramètres de l'application → E-mail
Activer la vérification par e-mail ou Réinitialisation du mot de passe.
Personnaliser les modèles d'e-mail.
Implémentation du code
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)")
    }
}
﻿
Étape 8 – Planification des tâches avec les travaux Cloud
Travaux Cloud
Automatisez les tâches récurrentes, comme le nettoyage des anciennes données ou l'envoi de mises à jour mensuelles :
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.`;
});
﻿
Dans le Tableau de bord Back4App → Paramètres de l'application → Paramètres du serveur → Travaux en arrière-plan, planifiez “cleanupOldScores” pour s'exécuter quotidiennement.
Planification d'un travail Cloud
﻿
Étape 9 – Intégration des Webhooks
Définition
Les Webhooks permettent à votre application Back4App d'envoyer des événements à des services externes. Cela pourrait être l'envoi de notifications à Slack, des mises à jour de paiement à Stripe, ou des données analytiques à votre serveur.
Configuration
Dans votre tableau de bord Back4App, allez à Plus → WebHooks → Ajouter un Webhook. Spécifiez un point de terminaison (comme https://myserver.com/webhook-endpoint) et les déclencheurs (mises à jour d'objet, nouveaux enregistrements, etc.).
Ajout d'un Webhook
﻿
Exemple
Notifier Slack lorsqu'un nouveau score élevé est créé :
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!`);
});
﻿
Étape 10 – Explorer le panneau d'administration Back4App
Où le trouver
L' Application d'administration Back4App est un tableau de bord convivial, centré sur le modèle pour gérer les données, effectuer des opérations CRUD ou modifier des classes—sans avoir besoin de requêtes directes à la base de données.
Activez-le via Tableau de bord de l'application → Plus → Application d'administration.
Activer l'application d'administration
﻿
Fonctionnalités
Une fois activé, vous pouvez inviter des membres de l'équipe ou des clients à gérer les données, vérifier les journaux ou ajuster les notifications push—leur donnant essentiellement un accès direct au backend de votre application tvOS.
Conclusion
En suivant ce tutoriel complet, vous avez :
Créé un backend sécurisé pour votre application tvOS en utilisant Back4App.
Configuré une base de données avec des classes, des types de données et des relations.
Mis en place des requêtes en temps réel pour refléter les changements immédiats.
Appliqué la sécurité à travers des ACL et des CLP.
Implémenté le Cloud Code pour une logique métier personnalisée et des intégrations.
Activé l'authentification avec vérification par e-mail et réinitialisation de mot de passe.
Géré les téléchargements de fichiers avec des contrôles de sécurité optionnels.
Planifié des tâches Cloud pour des tâches de routine.
Utilisé des webhooks pour s'intégrer à des services externes.
Exploré le panneau d'administration pour gérer et surveiller les données.
Vous êtes maintenant bien équipé pour créer des expériences Apple TV riches et de haute qualité. Votre application est construite sur une base solide—profitez de transformer vos idées d'application tvOS en réalité !
Prochaines étapes
Affinez votre interface tvOS: Intégrez une navigation basée sur le focus, des flux utilisateurs pour grands écrans, et les meilleures pratiques de l'App Store.
Améliorez la sécurité: Ajoutez un contrôle d'accès basé sur les rôles, une authentification multi-facteurs, ou un chiffrement avancé.
Approfondissez vos compétences: Explorez des fonctionnalités Parse Swift plus avancées comme le cache hors ligne ou les analyses personnalisées.
Consultez la documentation officielle: Back4App Docs et Apple tvOS Docs pour des connaissances plus approfondies.
Monétisation: Envisagez un abonnement ou un paiement à la séance pour élargir le potentiel de votre entreprise de streaming.
Avec les fondamentaux de ce guide, vous pouvez continuer à innover et à intégrer de nouvelles fonctionnalités. Bonne chance pour amener votre application tvOS au niveau supérieur!
Mis à jour 23 Jan 2025
Cette page vous a-t-elle aidée?
Comment construire un backend pour WatchOS ?
Comment construire un backend pour MacOS ?