Thử nghiệm, phát hành và chia sẻ Trò chơi tức thì

Với Trò chơi tức thì, chúng tôi đã tạo điều kiện để bạn thử nghiệm phiên bản phát triển cục bộ, tự động phát hành và chia sẻ bản dựng với đội ngũ của mình thực sự dễ dàng. Tài liệu này sẽ giải thích các bước đó một cách chi tiết.

Thử nghiệm game từ một máy chủ cục bộ

Phần lớn trải nghiệm Trò chơi tức thì đến từ các lớp phủ tự nhiên được thêm vào game trước và sau mỗi phiên chơi. Nhằm hỗ trợ quy trình phát triển và thử nghiệm, chúng tôi cho phép các nhà phát triển chạy game từ một máy chủ cục bộ có trải nghiệm giống hệt như những gì người chơi của họ sẽ thấy trong nền tảng của chúng tôi. Chúng tôi thực hiện điều này thông qua trình chơi thử nghiệm được nhúng của mình. Trình này yêu cầu ít cấu hình.

Bật SSL qua localhost

Vì trình chơi thử nghiệm được nhúng của chúng tôi đang hoạt động trong miền facebook.com nên chỉ phân phối được qua https. Để nhúng nội dung trong một trang được phân phối qua https, nội dung được nhúng đó cũng cần được phân phối qua SSL. Các bước tiếp theo sẽ hướng dẫn bạn thiết lập một máy chủ localhost để phân phối nội dung an toàn. Chúng tôi sẽ giới thiệu một lựa chọn ở bên dưới. Tuy nhiên, có nhiều giải pháp có thể cho phép hành vi này.

• 1. Cài đặt gói http-server qua npm. Nếu bạn chưa cài đặt npm, hãy làm theo hướng dẫn cài đặt trên trang web Node.JS. Sau đó, chạy lệnh sau:

> $ npm install -g http-server

• 2. Tạo một khóa riêng tư và một chứng chỉ qua openssl. Đây là bước cần thiết để chạy máy chủ cục bộ an toàn.

> $ 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. Chạy game từ localhost qua SSL. Sau khi khóa và chứng chỉ đã sẵn sàng, bạn có thể phân phối từ localhost qua 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. Sau đó, khi trỏ trình duyệt của mình đến https://localhost:8080, bạn sẽ thấy game đang chạy.

Chạy trình chơi được nhúng từ trình duyệt của bạn

Bây giờ, game đang được phân phối từ localhost qua một kết nối an toàn. Bạn có thể nhúng game đó vào trình chơi của chúng tôi. Hãy trỏ trình duyệt của bạn tại đây:

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

Bạn sẽ thấy game của mình đang chạy trong Trình chơi Trò chơi tức thì như sau:

Tại thời điểm này, bạn có thể sử dụng tất cả các tính năng của SDK Trò chơi tức thì từ game đang chạy trên máy chủ cục bộ của mình.

Chơi từ máy chủ cục bộ trong một cuộc trò chuyện cụ thể

Bạn có thể chạy game từ máy chủ cục bộ của mình trong một ngữ cảnh cụ thể. Để làm việc đó, bạn chỉ cần sử dụng trình chơi được nhúng như giải thích ở trên. Sau đó, bạn có thể tận dụng các phương thức FBInstant.context (chẳng hạn như switchAsync(), createAsync() và chooseAsync()) để chuyển sang các ngữ cảnh khác nhau.

Như vậy, bạn có thể chơi game từ localhost một cách hiệu quả trong ngữ cảnh cuộc trò chuyện và kiểm tra xem phần cập nhật ngữ cảnh của mình có được gửi đúng cách hay không.

Tải bản dựng của bạn lên

Nén game của bạn vào một file .zip

Nội dung Trò chơi tức thì được lưu trữ trên cơ sở hạ tầng của Facebook nên bạn không cần tự lưu trữ nội dung game hay sử dụng dịch vụ bên thứ ba. Sau khi game đã sẵn sàng thử nghiệm, hãy nén tất cả các file game vào một file .zip. Hãy lưu ý rằng file index.html phải nằm trong thư mục gốc của kho lưu trữ này và không nằm trong bất kỳ thư mục con nào. Có 2 cách tải gói của bạn lên:

1. Tải file .zip lên qua trang web của nhà phát triển

Để tải file .zip lên, hãy nhấp vào tab Lưu trữ web từ sản phẩm Trò chơi tức thì trong Bảng điều khiển ứng dụng. Từ đó, nhấp vào Tải phiên bản lên để tải file .zip lên dịch vụ lưu trữ của Facebook.

Sau đó, bản dựng sẽ xử lý file. Quá trình này chỉ mất vài giây. Khi trạng thái chuyển sang "Chế độ chờ", ứng dụng đã sẵn sàng phát hành chính thức!

2. Tải kho lưu trữ lên qua API Đồ thị

Ngoài ra, bạn có thể tải gói của mình lên qua lệnh gọi API Đồ thị. Cách này hữu ích nếu bạn có hệ thống triển khai tự động. Để thực hiện điều này, bạn cần yêu cầu mã tải lên từ phần Lưu trữ web bằng cách nhấp vào nút Nhận mã truy cập nội dung tải lên tài sản ở trên cùng.

Khi nhận được mã này từ hộp thoại, bạn có thể gửi lệnh gọi sau đến API Đồ thị của chúng tôi để gửi file .zip của mình. Lưu ý rằng chúng tôi đang sử dụng miền phụ video. Tuy nhiên, đây là hành động chủ ý vì URL đó được đặt cấu hình để nhận nội dung tải lên lớn hơn.

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'

Sau đó, game của bạn sẽ hiển thị bình thường trong danh sách các gói đã tải lên. Bạn có thể sử dụng lệnh gọi này để tích hợp với hệ thống bản dựng hiện có của mình.

Hạn chế về lưu trữ

Lưu ý rằng việc lưu trữ trên Facebook có một số hạn chế, quan trọng nhất là:

• Logic phía máy chủ (ví dụ: php) không được hỗ trợ.
• Tổng kích thước của các tệp đã tải lên không được vượt quá 200MB.
• Số lượng file trong một lần tải ứng dụng lên không được vượt quá 500 file.

Hãy xem tài liệu về Lưu trữ web để biết thêm thông tin.

Thử nghiệm bản dựng đã tải lên

Phát hành chính thức bản dựng

Để thử nghiệm bản tải lên trong môi trường chính thức, trước tiên, bản dựng phải được tách chuyển cho giai đoạn chính thức. Sau đó, nhấp vào nút "★" để phát hành chính thức bản dựng này.

Bản dựng chính thức là bản dựng sẽ được phân phối đến tất cả những người chơi game của bạn. Để thử nghiệm bản cập nhật chính thức mà không ảnh hưởng đến cơ sở người chơi hiện tại, bạn có thể tách chuyển bản dựng cho giai đoạn thử nghiệm. Như vậy, bản dựng này sẽ chỉ được phân phối đến nhà phát triển và người dùng thử ứng dụng.

Sau khi có bản dựng chính thức, hãy luôn thử nghiệm bản dựng đó thay cho bản dựng đang chạy trên máy chủ cục bộ của bạn. Bạn có thể thử nghiệm bản dựng chính thức bằng một trong các phương thức sau đây.

1. Chơi game của bạn trên Facebook

Để chia sẻ game của bạn trong Bảng tin, hãy nhấp vào nút Chia sẻ trong phần Chia sẻ trò chơi. Như vậy, bạn sẽ có thể chia sẻ game trong Bảng tin và thử nghiệm game đó trong mọi nền tảng (Máy tính, iOS hoặc Android).

2. Chơi game của bạn trên Messenger

Trong danh sách Trò chơi tức thì trên Messenger, bạn và đội ngũ của mình (những người được chỉ định vai trò "Quản trị viên", "Nhà phát triển" hoặc "Người dùng thử" trong ứng dụng của bạn) nên có một danh sách gồm tất cả các game đang được xây dựng. Danh sách này được gọi là Đang phát triển. Danh sách này hỗ trợ bạn thử nghiệm game trên Messenger ngay cả khi game đó chưa được phát hành.

3. Chia sẻ một liên kết đến game của bạn

Nếu đã liên kết một trang với game của mình, bạn cũng có thể tạo một liên kết có thể chia sẻ. Liên kết này sẽ đưa người dùng đến cuộc trò chuyện với bot của bạn trên Messenger và tự động mở game nếu bạn đã thiết lập bot. Nếu bạn chưa thiết lập, liên kết này sẽ đưa người dùng đến Trang của bạn trên Facebook và tự động mở game từ đó. Trong cả hai trường hợp trên, bất kỳ ai nhấp vào liên kết này đều có thể chơi game ngay lập tức.

Gửi đi Xét duyệt ứng dụng

Sau khi hài lòng với phiên bản đã phát hành của mình, bạn cần gửi game đi Xét duyệt ứng dụng để đội ngũ của chúng tôi có thể đánh giá xem game đó có đạt chất lượng cũng như tuân thủ Chính sách nền tảng của chúng tôi hay không. Hãy nhớ xem Danh sách kiểm tra khi phát hành của chúng tôi trước khi gửi và đảm bảo game của bạn đáp ứng tất cả các tiêu chí được chỉ định. Hướng dẫn đó cũng có những chỉ dẫn về cách phát hành game của bạn sau khi được xét duyệt.

Các bước tiếp theo

Bây giờ, bạn đã biết cách thử nghiệm và phát hành game của mình rồi. Hãy xem danh sách kiểm tra khi ra mắt của chúng tôi trước khi gửi game: Danh sách kiểm tra khi ra mắt Trò chơi tức thì. Ngoài ra, vui lòng xem phần Cách làm tốt nhất của chúng tôi để biết các đề xuất về thiết kế và bản cập nhật cho game của bạn.