Быстрые стартеры
Как построить бэкэнд для tvOS?

42min
Введение
В этом учебном пособии вы узнаете как создать бэкенд для tvOS приложений с использованием Back4App. 
Мы рассмотрим интеграцию основных функций Back4App — таких как управление базами данных, функции облачного кода, REST и GraphQL API, аутентификация пользователей и в реальном времени (Live Queries) — для создания безопасного, масштабируемого бэкенда, который бесшовно взаимодействует с вашим Apple TV приложением, созданным с помощью Parse Swift SDK.
Вы увидите, как упрощенная среда Back4App и быстрая настройка значительно сокращают время по сравнению с ручной конфигурацией серверов и баз данных. 
В процессе вы получите практический опыт с ключевыми функциями, включая расширенные функции безопасности, планирование облачных задач и интеграцию вебхуков.
К концу этого учебного пособия вы будете готовы улучшить эту базовую структуру до готового к производству приложения для tvOS или легко включить пользовательскую логику и сторонние API. Этот гид также поможет поддерживать высокое качество пользовательского опыта на Apple TV, используя ваш проект Xcode и существующие знания в области разработки iOS.
Предварительные требования
Чтобы завершить это учебное пособие, вам потребуется:
Аккаунт Back4App и новый проект Back4App
Начало работы с Back4app.
Если у вас нет аккаунта, вы можете создать его бесплатно. Следуйте приведенному выше руководству, чтобы подготовить ваш проект.
Установленная версия Xcode (последняя стабильная версия)
Вы будете создавать ваше приложение для tvOS с помощью Swift или SwiftUI. Убедитесь, что у вас есть самая последняя версия Xcode из Mac App Store.
Parse Swift SDK
Настройте Parse Swift SDK для подключения вашего приложения для tvOS.
Знание Swift и основных концепций разработки iOS/tvOS
Если вы новичок в Apple TV, сначала ознакомьтесь с документацией Apple tvOS или с учебным пособием для начинающих.
Убедитесь, что у вас есть все эти предварительные условия, прежде чем вы начнете. Наличие вашего проекта Back4App и локального Xcode проекта поможет вам легче следовать инструкциям.
Шаг 1 – Создание нового проекта на Back4App и подключение
Создать новый проект
Первый шаг в создании вашего tvOS приложения на Back4App – это создание нового проекта. Если вы еще этого не сделали, выполните следующие шаги:
Войдите в свою учетную запись Back4App.
Нажмите кнопку “Новое приложение” на вашей панели управления Back4App.
Дайте вашему приложению имя (например, “tvOS-Backend-Tutorial”).
﻿
После создания вы увидите проект в списке на вашей панели управления Back4App. Этот новый проект Back4App является основой всех конфигураций бэкенда, рассмотренных в этом учебном пособии.
Подключите Parse Swift SDK
Back4App использует Parse для обработки хранения данных, аутентификации пользователей, функций в реальном времени и многого другого. Чтобы подключить ваше tvOS приложение к Back4App, установите и настройте Parse Swift SDK в вашем Xcode проекте.
Получите ваши ключи Parse:
В вашей панели управления Back4App перейдите в “Настройки приложения” или “Безопасность и ключи”, чтобы найти ваш ID приложения и Ключ клиента. Вы также увидите URL сервера Parse—обычно https://parseapi.back4app.com.
﻿
Установите Parse Swift SDK в вашем проекте tvOS:
Swift Package Manager (Рекомендуется)
В Xcode выберите Файл → Добавить пакеты.
Введите URL GitHub для Parse Swift: 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”).
Добавьте соответствующие столбцы (score, playerName и т.д.).
Создать новый класс
﻿
Создание модели данных с использованием AI-агента
AI-агент Back4App может автоматически разработать вашу схему:
Откройте AI-агента в вашей панели управления Back4App.
Опишите вашу модель (например, “Создать класс ToDo с полем title и isCompleted”).
Применить и позвольте 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 защищает ваши данные с помощью ACL (Списков управления доступом) и CLP (Разрешений на уровне класса). Используйте их для определения правил чтения/записи на уровне объекта или класса.
﻿
Разрешения на уровне класса
Перейдите в базу данных, выберите класс (например, GameScore).
Нажмите “Безопасность” или “Разрешения на уровне класса”.
Установите, кто может читать, писать или удалять (например, только аутентифицированные пользователи).
ACL в коде
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"
  }
}
﻿
Затем подключите или импортируйте их в main.js для использования в Cloud Code.
Шаг 5 – Настройка аутентификации
Аутентификация пользователей в Back4App
Приложения tvOS часто нуждаются в синхронизации данных пользователей или входе в систему. 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 Dashboard → Настройки приложения → Настройки сервера → Фоновая работа, запланируйте “cleanupOldScores” для ежедневного выполнения.
Планирование облачного задания
﻿
Шаг 9 – Интеграция вебхуков
Определение
Вебхуки позволяют вашему приложению Back4App отправлять события во внешние сервисы. Это может быть отправка уведомлений в Slack, обновлений платежей в Stripe или аналитических данных на ваш сервер.
Конфигурация
В вашем Back4App Dashboard перейдите в Дополнительно → Вебхуки → Добавить вебхук. Укажите конечную точку (например, 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 Admin App — это удобная, ориентированная на модели панель управления для управления данными, выполнения операций CRUD или редактирования классов — без необходимости прямых запросов к базе данных.
Включите его через Панель управления приложением → Дополнительно → Приложение администратора.
Включите приложение администратора
﻿
Функции
После включения вы можете пригласить членов команды или клиентов управлять данными, проверять журналы или настраивать push-уведомления — по сути, предоставляя им прямой доступ к бэкенду вашего tvOS приложения.
Заключение
Следуя этому подробному руководству, вы:
Создали безопасный бэкенд для вашего tvOS приложения с использованием Back4App.
Настроили базу данных с классами, типами данных и отношениями.
Настроили запросы в реальном времени для отражения немедленных изменений.
Применили безопасность через ACL и CLP.
Реализовали Cloud Code для пользовательской бизнес-логики и интеграций.
Включили аутентификацию с проверкой электронной почты и сбросом пароля.
Обработали загрузку файлов с дополнительными контролями безопасности.
Запланировали Cloud Jobs для рутинных задач.
Использовали вебхуки для интеграции с внешними сервисами.
Изучили панель администратора для управления и мониторинга данных.
Теперь вы хорошо подготовлены к созданию насыщенных, высококачественных Apple TV приложений. Ваше приложение построено на прочной основе — наслаждайтесь превращением ваших tvOS приложений в реальность!
Следующие шаги
Уточните свой интерфейс tvOS: Внедрите навигацию на основе фокуса, пользовательские потоки для больших экранов и лучшие практики App Store.
Улучшите безопасность: Добавьте управление доступом на основе ролей, многофакторную аутентификацию или расширенное шифрование.
Углубите свои навыки: Изучите более продвинутые функции Parse Swift, такие как оффлайн-кэширование или пользовательская аналитика.
Посмотрите официальные документы: Документы Back4App и Документы Apple tvOS для более глубоких знаний.
Монетизация: Рассмотрите возможность подписки или оплаты за просмотр, чтобы расширить потенциал вашего стримингового бизнеса.
С основами из этого руководства вы можете продолжать внедрять инновации и интегрировать новые функции. Удачи в продвижении вашего приложения tvOS на следующий уровень!
Обновлено 23 Jan 2025
Помогла ли вам эта страница?
Как построить бекенд для WatchOS?
Как создать серверную часть для MacOS?