Jalankan proyek demo ARTC untuk iOS - ApsaraVideo Live

Topik ini menjelaskan cara menjalankan proyek demo ApsaraVideo Real-time Communication (ARTC) untuk mencoba fitur ARTC pada iOS.

Unduh kode sumber

ApsaraVideo Live menyediakan proyek contoh open-source untuk menunjukkan penggunaan API ARTC SDK, membantu pengembang memahami dan mengintegrasikan fitur ARTC. Untuk mengunduh kode sumber, kunjungi repositori GitHub.

Persyaratan lingkungan

Sebelum menjalankan proyek demo, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

Alat pengembangan: Xcode 14.0 atau lebih baru. Versi resmi terbaru direkomendasikan.
Konfigurasi yang direkomendasikan: CocoaPods 1.9.3 atau lebih baru.
Perangkat uji: Perangkat yang menjalankan iOS 9.0 atau lebih baru.

Catatan

Kami merekomendasikan menggunakan perangkat fisik untuk pengujian, karena emulator mungkin tidak mendukung semua fitur.

Jaringan: Koneksi Internet yang stabil.
Pengaturan aplikasi: Dapatkan AppID dan AppKey dari aplikasi ARTC.

Prosedur

Langkah 1: Dapatkan proyek demo

Kloning proyek demo ARTC ke perangkat lokal Anda:

git clone https://github.com/MediaBox-Demos/amdemos-artc

Catatan

Repositori ini berisi proyek demo untuk beberapa platform asli. Proyek demo iOS terletak di direktori iOS/.

Proyek demo mencakup kode untuk menghasilkan token di sisi klien. Ini hanya untuk tujuan demonstrasi dan pengujian. Dalam lingkungan produksi, token harus dihasilkan di server yang aman untuk melindungi AppKey Anda.

Struktur file proyek iOS/ARTCExample:

├── iOS                                    // Direktori root untuk proyek iOS
│   ├── ARTCExample                        // Direktori proyek Contoh API
│       ├── Common                         // Modul umum
│           ├── ARTCTokenHelper.swift      // Informasi AppId dan AppKey
│           ├── ...                        // File lainnya
│       ├── QuickStart                     // Modul mulai cepat
│           ├── TokenGenerate              // Pembuatan token dan bergabung dengan saluran
│           ├── VideoCall                  // Implementasi cepat panggilan audio/video
│           ├── VoiceChat                  // Implementasi cepat ruang obrolan suara
│       ├── Setting                        // Modul Pengaturan
│       ├── ...                            // File proyek lainnya
│   ├── ARTCExample.xcodeproj              // File proyek Xcode untuk demo
│   ├── ARTCExample.xcworkspace            // Workspace Xcode untuk demo
│   ├── Podfile                            // Podfile demo

Langkah 2: Konfigurasikan proyek demo

Setelah mengunduh kode sumber, buka direktori iOS di terminal.
Di direktori iOS, jalankan perintah pod install --repo-update untuk menginstal dependensi SDK yang diperlukan.
Buka file ARTCExample.xcworkspace di Xcode.
Navigasikan ke file iOS/ARTCExample/Common/ARTCTokenHelper.swift dan masukkan AppID dan AppKey yang diperoleh dari Konsol.

// ARTCTokenHelper.swift
class ARTCTokenHelper: NSObject {
    /**
     * RTC AppId
     */
    public static let AppId = "<AppID aplikasi ARTC Anda>"
    /**
     * RTC AppKey
     */
    public static let AppKey = "<AppKey AppID aplikasi ARTC Anda>"
    
    ...
}

Langkah 3: Kompilasi dan jalankan proyek demo

Pilih Target ARTCExample, sambungkan perangkat fisik ke komputer Anda, dan kompilasi untuk menginstal aplikasi.
Jalankan aplikasi pada perangkat uji untuk mencoba fitur ARTC.

Di perangkat uji, buka aplikasi dan ketuk Video Call untuk menguji fitur ini.

Untuk menguji panggilan video, gunakan ID saluran yang sama untuk bergabung dalam panggilan pada dua perangkat.

Panggilan dimulai, dan Anda dapat melihat aliran video dari kedua perangkat.