Quickstarters
Cara Membangun Backend untuk tvOS?

42min
Pendahuluan
Dalam tutorial ini, Anda akan belajar cara membangun backend untuk tvOS aplikasi menggunakan Back4App. 
Kami akan membahas integrasi fitur-fitur penting Back4App—seperti manajemen database, Cloud Code Functions, REST dan GraphQL APIs, otentikasi pengguna, dan real-time (Live Queries)—untuk membuat backend yang aman dan skalabel yang berkomunikasi dengan mulus dengan aplikasi Apple TV Anda yang dibangun dengan Parse Swift SDK.
Anda akan melihat bagaimana lingkungan Back4App yang efisien dan pengaturan cepat secara drastis mengurangi waktu dibandingkan dengan mengonfigurasi server dan database secara manual. 
Sepanjang jalan, Anda akan mendapatkan pengalaman langsung dengan fungsionalitas kunci, termasuk fitur keamanan tingkat lanjut, penjadwalan pekerjaan cloud, dan integrasi webhook.
Pada akhir tutorial ini, Anda akan siap untuk meningkatkan struktur dasar ini menjadi aplikasi tvOS yang siap produksi atau dengan mudah menyertakan logika kustom dan API pihak ketiga. Panduan ini juga akan membantu menjaga pengalaman pengguna yang tinggi di Apple TV, memanfaatkan proyek Xcode Anda dan pengetahuan pengembangan iOS yang ada.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:
Akun Back4App dan proyek Back4App baru
Memulai dengan Back4app.
Jika Anda tidak memiliki akun, Anda dapat membuat satu secara gratis. Ikuti panduan di atas untuk menyiapkan proyek Anda.
Xcode (versi stabil terbaru) terinstal
Anda akan membangun aplikasi tvOS Anda dengan Swift atau SwiftUI. Pastikan Anda memiliki Xcode terbaru dari Mac App Store.
Parse Swift SDK
Siapkan Parse Swift SDK untuk menghubungkan aplikasi tvOS Anda.
Keterampilan dalam Swift dan konsep dasar pengembangan iOS/tvOS
Jika Anda baru mengenal Apple TV, tinjau dokumentasi Apple tvOS atau tutorial pemula terlebih dahulu.
Pastikan Anda memiliki semua prasyarat ini sebelum Anda mulai. Memiliki proyek Back4App Anda siap dan proyek Xcode tvOS lokal yang disiapkan akan membantu Anda mengikuti lebih mudah.
Langkah 1 – Membuat Proyek Baru di Back4App dan Menghubungkan
Buat Proyek Baru
Langkah pertama dalam membangun backend aplikasi tvOS Anda di Back4App adalah membuat proyek baru. Jika Anda belum melakukannya, ikuti langkah-langkah ini:
Masuk ke akun Back4App Anda.
Klik tombol “Aplikasi Baru” di dasbor Back4App Anda.
Beri nama aplikasi Anda (misalnya, “tvOS-Backend-Tutorial”).
﻿
Setelah dibuat, Anda akan melihat proyek tersebut terdaftar di dasbor Back4App Anda. Proyek Back4App baru ini adalah inti dari semua konfigurasi backend yang dibahas dalam tutorial ini.
Hubungkan SDK Parse Swift
Back4App memanfaatkan Parse untuk menangani penyimpanan data, otentikasi pengguna, fitur real-time, dan lainnya. Untuk menghubungkan aplikasi tvOS Anda ke Back4App, instal dan konfigurasikan Parse Swift SDK di proyek Xcode Anda.
Ambil Kunci Parse Anda:
Di dasbor Back4App Anda, pergi ke “Pengaturan Aplikasi” atau “Keamanan & Kunci” untuk menemukan ID Aplikasi dan Kunci Klien. Anda juga akan melihat URL Server Parse—umumnya https://parseapi.back4app.com.
﻿
Instal Parse Swift SDK di proyek tvOS Anda:
Pengelola Paket Swift (Direkomendasikan)
Di Xcode, pilih File → Tambahkan Paket.
Masukkan URL GitHub Parse Swift: https://github.com/netreconlab/Parse-Swift.git
Pilih versi yang sesuai atau cabang utama.
CocoaPods
Jika Anda lebih suka CocoaPods, tambahkan yang berikut ke Podfile Anda:
Ruby
pod 'ParseSwiftOG'
pod 'ParseSwiftOG'
﻿
Kemudian jalankan pod install.
Inisialisasi Parse di AppDelegate Anda atau @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()
        }
    }
}
﻿
Ini memastikan aplikasi tvOS Anda dibangun untuk berkomunikasi dengan backend Back4App, memungkinkan Anda menyimpan data, menjalankan kueri, mengautentikasi pengguna, dan banyak lagi.
Langkah 2 – Menyiapkan Database
Membuat Model Data
Dengan aplikasi tvOS Anda sekarang terhubung ke Back4App, Anda dapat membuat dan mengelola data. Di Parse Swift, Anda mendefinisikan 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?
}
﻿
Anda juga dapat mendefinisikan kelas secara manual di dasbor Back4App Anda:
Pergi ke “Database” di konsol Back4App.
Buat kelas baru (misalnya, “GameScore”).
Tambahkan kolom yang relevan (skor, namaPemain, dll.).
Buat Kelas Baru
﻿
Membuat Model Data Menggunakan AI Agent
AI Agent Back4App dapat secara otomatis merancang skema Anda:
Buka AI Agent di Dasbor Back4App Anda.
Deskripsikan model Anda (misalnya, “Buat kelas ToDo dengan judul dan field isCompleted”).
Terapkan dan biarkan AI Agent menghasilkan skema.
﻿
Membaca dan Menulis Data Menggunakan 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)")
    }
}
﻿
Membaca dan Menulis Data Menggunakan 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
﻿
Membaca dan Menulis Data Menggunakan 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
    }
  }
}
﻿
Bekerja dengan Live Queries (opsional)
Live Queries dapat memberikan pembaruan waktu nyata di Apple TV antarmuka Anda—sangat berguna untuk aplikasi multi-pemain atau papan peringkat.
Aktifkan Live Queries di Pengaturan Server aplikasi Anda di Back4App.
Inisialisasi sebuah langganan:
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
    }
}
﻿
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Ikhtisar
Back4App mengamankan data Anda dengan ACL (Daftar Kontrol Akses) dan CLP (Izin Tingkat Kelas). Gunakan mereka untuk mendefinisikan aturan baca/tulis di tingkat objek atau kelas.
﻿
Izin Tingkat Kelas
Pergi ke Database, pilih sebuah kelas (misalnya, GameScore).
Klik “Keamanan” atau “Izin Tingkat Kelas”.
Tetapkan siapa yang dapat membaca, menulis, atau menghapus (misalnya, hanya pengguna yang terautentikasi).
ACL dalam Kode
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
﻿
Langkah 4 – Menulis Fungsi Cloud Code
Mengapa Cloud Code?
Cloud Code memungkinkan Anda untuk memindahkan logika penting dari klien Anda ke kode sisi server yang aman. Ini sangat baik untuk aturan bisnis, validasi data, atau integrasi pihak ketiga tanpa mengekspos rahasia dalam aplikasi tvOS Anda.
Contoh Fungsi
Di 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;
});
﻿
Penerapan
Back4App CLI:
Bash
b4a configure accountkey
b4a deploy
b4a configure accountkey
b4a deploy
﻿
atau gunakan Back4App Dashboard → Cloud Code → Functions → main.js.
Memanggil dari 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)")
    }
}
﻿
Modul NPM
Di dalam package.json, tambahkan dependensi:
JSON
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
﻿
Kemudian minta atau impor mereka di main.js untuk digunakan dalam Cloud Code.
Langkah 5 – Mengonfigurasi Autentikasi
Autentikasi Pengguna di Back4App
Aplikasi tvOS sering memerlukan sinkronisasi data pengguna atau login. ParseUser menyediakan pendaftaran yang aman, login, sesi, dan akses berbasis peran.
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]?]?
}
﻿
Daftar / Masuk
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)")
    }
}
﻿
Login Sosial
Konfigurasi Masuk dengan Facebook atau Apple. Kemudian tautkan akun:
Swift
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
﻿
Langkah 6 – Menangani Penyimpanan File
Mengatur Penyimpanan File
Unggah gambar pengguna, replay game, atau aset aplikasi menggunakan 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)")
}
﻿
Contoh
Lampirkan file ke objek:
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?
}
﻿
Pertimbangan Keamanan
Gunakan CLP atau ACL untuk mengamankan referensi file. URL langsung dari file dapat diakses publik kecuali Anda mengaktifkan Keamanan File.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Ikhtisar
Verifikasi email membantu mengonfirmasi kepemilikan akun email oleh pengguna. Reset kata sandi menawarkan cara yang aman dan ramah pengguna untuk mendapatkan kembali akses akun.
Konfigurasi Dasbor Back4App
Di aplikasi Anda → Pengaturan Aplikasi → Email
Aktifkan verifikasi email atau Reset kata sandi.
Sesuaikan template email.
Implementasi Kode
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)")
    }
}
﻿
Langkah 8 – Penjadwalan Tugas dengan Pekerjaan Cloud
Pekerjaan Cloud
Otomatisasi tugas berulang, seperti membersihkan data lama atau mengirim pembaruan bulanan:
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.`;
});
﻿
Di Dasbor Back4App → Pengaturan Aplikasi → Pengaturan Server → Pekerjaan Latar Belakang, jadwalkan “cleanupOldScores” untuk dijalankan setiap hari.
Menjadwalkan Pekerjaan Cloud
﻿
Langkah 9 – Mengintegrasikan Webhook
Definisi
Webhook memungkinkan aplikasi Back4App Anda untuk mengirimkan peristiwa ke layanan eksternal. Ini bisa berupa mengirim notifikasi ke Slack, pembaruan pembayaran ke Stripe, atau data analitik ke server Anda.
Konfigurasi
Di Dasbor Back4App Anda, pergi ke Lainnya → Webhook → Tambahkan Webhook. Tentukan endpoint (seperti https://myserver.com/webhook-endpoint) dan pemicu (pembaruan objek, catatan baru, dll.).
Menambahkan Webhook
﻿
Contoh
Beri tahu Slack ketika skor tinggi baru dibuat:
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!`);
});
﻿
Langkah 10 – Menjelajahi Panel Admin Back4App
Di Mana Menemukannya
Aplikasi Back4App Admin adalah dasbor yang ramah pengguna, berbasis model untuk mengelola data, melakukan CRUD, atau mengedit kelas—tanpa perlu kueri database langsung.
Aktifkan melalui Dasbor Aplikasi → Lainnya → Aplikasi Admin.
Aktifkan Aplikasi Admin
﻿
Fitur
Setelah diaktifkan, Anda dapat mengundang anggota tim atau klien untuk mengelola data, memeriksa log, atau menyesuaikan notifikasi push—pada dasarnya memberi mereka portal langsung ke backend dari aplikasi tvOS Anda.
Kesimpulan
Dengan mengikuti tutorial komprehensif ini, Anda telah:
Membuat backend yang aman untuk aplikasi tvOS Anda menggunakan Back4App.
Mengonfigurasi database dengan kelas, tipe data, dan hubungan.
Menyiapkan kueri waktu nyata untuk mencerminkan perubahan segera.
Menerapkan keamanan melalui ACL dan CLP.
Mengimplementasikan Cloud Code untuk logika bisnis dan integrasi kustom.
Mengaktifkan otentikasi dengan verifikasi email dan pengaturan ulang kata sandi.
Menangani unggahan file dengan kontrol keamanan opsional.
Menjadwalkan Cloud Jobs untuk tugas rutin.
Menggunakan webhook untuk mengintegrasikan dengan layanan eksternal.
Menjelajahi Panel Admin untuk mengelola dan memantau data.
Anda sekarang sudah siap untuk membangun pengalaman Apple TV yang kaya, berkualitas tinggi. Aplikasi Anda dibangun di atas fondasi yang kuat—nikmati mengubah ide aplikasi tvOS Anda menjadi kenyataan!
Langkah Selanjutnya
Perbaiki UI tvOS Anda: Gabungkan navigasi berbasis fokus, alur pengguna layar besar, dan praktik terbaik App Store.
Tingkatkan keamanan: Tambahkan ACL berbasis peran, otentikasi multi-faktor, atau enkripsi lanjutan.
Perdalam keterampilan Anda: Jelajahi fitur Parse Swift yang lebih canggih seperti caching offline atau analitik kustom.
Periksa dokumen resmi: Dokumen Back4App dan Dokumen Apple tvOS untuk pengetahuan yang lebih dalam.
Monetisasi: Pertimbangkan langganan atau bayar per tayang untuk memperluas potensi bisnis streaming Anda.
Dengan dasar-dasar dari panduan ini, Anda dapat terus berinovasi dan mengintegrasikan fitur baru. Semoga sukses membawa aplikasi tvOS Anda ke tingkat berikutnya!
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Cara Membangun Backend untuk WatchOS?
BERIKUTNYA
Cara Membangun Backend untuk MacOS?