Menguji, Menerbitkan, dan Membagikan Game Instan

Dengan Game Instan, kami sudah memudahkan Anda untuk menguji versi pengembangan Anda secara lokal, menerbitkan otomatis, dan membagikan build bersama tim. Dokumen ini akan menjelaskan langkah-langkahnya secara terperinci.

Menguji game dari server lokal

Bagian besar dari pengalaman Game Instan hadir dari overlay native yang ditambahkan ke game sebelum dan sesudah tiap sesi permainan. Untuk memfasilitasi alur kerja pengembangan dan pengujian, kami memungkinkan developer untuk menjalankan game dari server lokal dengan pengalaman yang sangat mirip dengan apa yang akan didapat oleh pemain di platform kami. Ini dilakukan melalui pemain uji tersemat kami, yang hanya membutuhkan sedikit konfigurasi.

Mengaktifkan SSL melalui localhost

Karena pemutar uji tersemat kami bekerja di bawah domain facebook.com, ini hanya bisa disajikan melalui https. Untuk menyematkan konten dalam halaman yang disajikan melalui https, konten tersemat juga harus disajikan melalui SSL. Langkah selanjutnya akan membimbing Anda melalui penyiapan server localhost yang menyajikan konten aman. Kami menampilkan salah satu opsi di bawah, tetapi ada banyak solusi yang dimungkinkan untuk mengaktifkan perilaku ini.

• 1. Instal paket http-server melalui npm. Jika Anda belum menginstal npm, ikuti petunjuk penginstalan di situs web Node.JS. Setelah itu, jalankan perintah berikut:

> $ npm install -g http-server

• 2. Buat kode pribadi dan sertifikat melalui openssl. Ini diperlukan untuk menjalankan server lokal aman.

> $ cd path/to/my/game/
> $ openssl genrsa 2048 > key.pem
> $ openssl req -x509 -days 1000 -new -key key.pem -out cert.pem
# Fill out necessary information

• 3. Jalankan game dari localhost dengan SSL. Setelah kode dan sertifikat siap, Anda bisa melayani dari localhost menggunakan SSL.

# Starts to serve via HTTPS, with cache disabled
> $ http-server --ssl -c-1 -p 8080 -a 127.0.0.1 
Starting up http-server, serving ./ through https
Available on:
https://127.0.0.1:8080
Hit CTRL-C to stop the server

• 4. Setelah ini, dengan mengarahkan browser ke https://localhost:8080, game yang berjalan seharusnya akan ditampilkan kepada Anda.

Menjalankan pemain tersemat dari browser Anda

Sekarang karena game disajikan dari localhost melalui koneksi aman, Anda dapat menyematkannya di game kami. Arahkan browser Anda ke sini:

https://www.facebook.com/embed/instantgames/YOUR_GAME_ID/player?game_url=https://localhost:8080

Anda seharusnya melihat game Anda berjalan di Pemain Game Instan, seperti ini:

Pada titik ini, Anda harus dapat menggunakan semua fitur SDK Game Instan dari game yang dijalankan di server lokal Anda.

Bermain dari server lokal dalam percakapan tertentu

Anda dapat menjalankan game dari server lokal Anda dalam konteks tertentu. Untuk melakukannya, cukup gunakan pemain tersemat seperti yang dijelaskan di atas. Anda kemudian dapat memanfaatkan metode FBInstant.context (seperti switchAsync(), createAsync(), dan chooseAsync()) untuk beralih ke konteks yang berbeda.

Ini memungkinkan Anda secara efektif memainkan game dari localhost dalam konteks percakapan dan untuk menguji apakah pembaruan konteks Anda dikirim dengan benar.

Mengunggah build Anda

Kemas game Anda ke dalam file .zip tunggal

Konten Game Instan di-hosting di infrastruktur Facebook, jadi Anda tidak perlu melakukan hosting konten game tersebut ke layanan milik Anda sendiri atau layanan pihak ketiga. Setelah game siap untuk pengujian, kemas semua file game ke dalam file .zip tunggal. Harap diketahui bahwa file index.html harus berada di akar arsip ini dan tidak di sub-folder. Ada dua cara mengunggah bundel Anda:

1. Unggah file .zip melalui situs web developer

Untuk mengunggah file .zip, klik tab Hosting Web dari produk Game Instan di Dasbor Aplikasi. Dari sana, klik Versi Unggah yang akan memungkinkan Anda mengunggah file .zip ke layanan hosting Facebook.

Setelah itu, build akan memproses file, yang mana semestinya hanya memerlukan beberapa detik. Ketika status berubah ke "Siaga", aplikasi tersebut siap didorong ke produksi!

2. Mengunggah arsip melalui Graph API

Selain itu, Anda dapat mengunggah bundel Anda melalui panggilan Graph API. Ini berguna jika Anda memiliki sistem penerapan otomatis. Untuk melakukan ini, Anda perlu meminta token unggah dari bagian Web Hosting, dengan mengeklik tombol Dapatkan Token Akses Unggah Aset di bagian atas.

Dengan token dari dialog, Anda dapat mengirimkan panggilan berikut ke Graph API kami untuk mengirimkan .zip Anda. Perhatikan bahwa kami menggunakan sub-domain video, tetapi itu disengaja, karena URL dikonfigurasi untuk menerima unggahan yang lebih besar.

curl -X POST https://graph-video.facebook.com/{App ID}/assets 
  -F 'access_token={ASSET UPLOAD ACCESS TOKEN}' 
  -F 'type=BUNDLE' 
  -F 'asset=@./{YOUR GAME}.zip' 
  -F 'comment=Graph API upload'

Setelah itu, game Anda akan muncul secara normal di daftar bundel yang diunggah. Anda dapat menggunakan panggilan ini untuk mengintegrasikan dengan sistem build yang sudah ada.

Pembatasan hosting

Perhatikan bahwa hosting Facebook memiliki beberapa pembatasan, yang terpenting:

• Logika server (misalnya: php) tidak didukung.
• Ukuran total file yang diunggah tidak boleh melebihi 200MB.
• Jumlah file dalam satu aplikasi yang diunggah tidak boleh melebihi 500.

Periksa dokumentasi Hosting Web untuk detail selengkapnya.

Menguji build yang diunggah

Memproduksi Build

Guna menguji unggahan di lingkungan produksi, build tersebut harus disiapkan untuk tahap produksi. Klik tombol "★" untuk mendorong build ke produksi.

Build produksi Anda adalah build yang akan disajikan ke setiap orang yang memainkan game tersebut. Untuk menguji pembaruan Anda dalam produksi tanpa memengaruhi basis pemain yang sudah ada, Anda dapat membuat build untuk pengujian. Ini akan menyebabkan build disajikan hanya kepada developer dan penguji aplikasi tersebut.

Setelah Anda memiliki build di "produksi", Anda mungkin ingin menguji build tersebut, alih-alih menjalankan build di server lokal Anda. Anda dapat menguji build produksi menggunakan salah satu metode berikut.

1. Mainkan game Anda di Facebook

Untuk membagikan game Anda di Kabar, klik tombol Bagikan di bagian Bagikan Game Anda. Dengan ini, Anda dapat membagikan game tersebut di Kabar dan mengujinya dari permukaan mana saja (Desktop, iOS, atau Android).

2. Mainkan game Anda di Messenger

Di daftar Game Instan di Messenger, Anda dan tim Anda (orang-orang yang ditetapkan untuk berperan sebagai "Admin", "Developer", atau "Penguji" di aplikasi Anda) harus memiliki daftar semua game yang sedang dibuat. Daftar ini disebut Dalam pengembangan. Ini membantu Anda menguji game di Messenger, meskipun belum diterbitkan.

3. Bagikan tautan ke game Anda

Jika Anda telah menghubungkan halaman dengan game Anda, maka Anda juga dapat membuat tautan yang dapat dibagikan. Tautan ini akan mengantar pengguna ke percakapan dengan bot Anda di Messenger dan membuka game secara otomatis jika Anda telah mengatur bot-nya. Jika belum, maka tautan tersebut akan mengantar pengguna ke Halaman Anda di Facebook dan membuka game-nya secara otomatis dari halaman tersebut. Apa pun hasilnya, siapa pun yang mengeklik tautan tersebut akan dapat langsung memainkan game-nya.

Ajukan untuk Tinjauan Aplikasi

Setelah Anda puas dengan versi game yang Anda terbitkan, Anda harus mengajukan game Anda untuk Tinjauan Aplikasi agar tim kami dapat mengevaluasi kualitas dan kesesuaiannya dengan Kebijakan Platform kami. Pastikan untuk memeriksa Daftar Periksa Rilis sebelum pengajuan dan pastikan bahwa game Anda memenuhi semua kriteria yang ditentukan. Panduan itu juga memuat petunjuk mengenai cara menerbitkan game Anda setelah game tersebut selesai ditinjau.

Langkah berikutnya

Setelah Anda mengetahui cara menguji dan menerbitkan game Anda, lihat daftar periksa peluncuran kami sebelum mengirimkan game Anda: Daftar Periksa Peluncuran Game Instan. Lihat juga bagian Praktik Terbaik kami untuk rekomendasi mengenai desain dan pembaruan bagi game Anda.