Yêu cầu về việc tích hợp

Phần này trình bày về việc tích hợp giữa tính năng Chơi game và YouTube Playables SDK.

1 Tải Playables SDK

2 Thông báo Trò chơi đã sẵn sàng

  • Trò chơi PHẢI gọi firstFrameReady khi trò chơi đang kết xuất màn hình tải hoặc màn hình chờ cho người dùng biết rõ rằng quá trình tải đang diễn ra.
  • Trò chơi PHẢI gọi gameReady và CHỈ gọi gameReady khi trò chơi đã sẵn sàng cho lượt tương tác của người dùng (ví dụ: trình đơn chính hoặc trò chơi đã sẵn sàng để chơi).
  • Trò chơi KHÔNG ĐƯỢC gọi gameReady trong khi người dùng vẫn thấy các phần tử không tương tác (ví dụ: màn hình chờ hoặc màn hình tải).

YouTube sẽ không xoá "vòng quay tải" cho đến khi API này được gọi.

3 Điểm số của người dùng

  • Trò chơi CÓ THỂ sử dụng sendScore để gửi điểm số của người dùng.
  • Nếu trò chơi sử dụng sendScore để gửi điểm số, thì trò chơi PHẢI tuân thủ quy cách sendScore và PHẢI đảm bảo rằng điểm số cao nhất được gửi khớp với điểm số cao nhất trong tệp lưu trò chơi.

4 Lưu vào đám mây

  • Trò chơi PHẢI gọi saveData để lưu tiến trình khi người dùng đã đạt được tiến trình đáng kể trong trò chơi (ví dụ: thay đổi cấp độ) mà cơ chế trò chơi khiến người dùng tin rằng tiến trình của họ đã được lưu.
  • Trò chơi KHÔNG ĐƯỢC sử dụng bất kỳ cơ chế nào khác để lưu tiến trình của người dùng. Tính năng này cho phép người chơi tiếp tục chơi trò chơi vào lúc khác.
  • Trò chơi PHẢI đợi loadData trước khi gọi saveData. Nếu saveData được gọi trước khi loadData hoàn tất thành công, thì yêu cầu sẽ bị từ chối. Điều này giúp trò chơi không ghi đè bất kỳ dữ liệu nào đã lưu trước đó.
  • Trò chơi PHẢI có thể sử dụng dữ liệu lưu trên đám mây từ các phiên bản trước của trò chơi mà không gặp lỗi hoặc sự cố.
  • Trò chơi NÊN sử dụng dữ liệu lưu trên đám mây để duy trì tiến trình của người dùng trên tất cả các phiên bản trò chơi mà người dùng muốn sử dụng dữ liệu của họ.
  • Trò chơi NÊN tự động lưu tiến trình của người dùng tại các mốc quan trọng trong trò chơi để ngăn chặn tình trạng mất dữ liệu. Thao tác lưu dữ liệu cuối cùng được thực hiện khi người dùng thoát trò chơi, nhưng đây là thao tác tốt nhất và chỉ có thể lưu tối đa 64 KiB nội dung.

5 Nút bật hoặc tắt tiếng

  • Trò chơi PHẢI tuân thủ chế độ cài đặt âm thanh hệ thống và nút tắt micrô.
  • Trò chơi PHẢI tuân thủ chế độ cài đặt âm thanh và nút tắt micrô của YouTube bằng cách sử dụng isAudioEnabled và onAudioEnabledChange.
  • Trò chơi PHẢI tôn trọng chế độ điều khiển âm lượng trên thiết bị.
  • Âm thanh của trò chơi KHÔNG ĐƯỢC phát đột ngột.
  • Khi chế độ tắt tiếng trên YouTube được bật, âm thanh KHÔNG ĐƯỢC phát ra và các chế độ điều khiển âm thanh trong trò chơi KHÔNG ĐƯỢC ảnh hưởng đến đầu ra âm thanh.
  • Khi chế độ tắt tiếng trên YouTube chưa được thiết lập, các chế độ điều khiển âm thanh trong trò chơi CÓ THỂ ảnh hưởng đến đầu ra âm thanh.
  • Trò chơi KHÔNG NÊN hiển thị nút tắt tiếng tổng thể trong chính trò chơi; cho phép người dùng dựa vào các tính năng ở cấp YouTube cho việc này.
  • Trò chơi CÓ THỂ có các chế độ kiểm soát âm thanh riêng biệt và chi tiết trong trò chơi, chẳng hạn như cho nhạc và hiệu ứng âm thanh, nhưng PHẢI tuân thủ tất cả các yêu cầu khác về chế độ kiểm soát âm thanh.

Các chế độ cài đặt âm thanh khác nhau cho nền, hiệu ứng âm thanh, đoạn hội thoại

6 Tạm dừng và tiếp tục

Playables SDK cung cấp các lệnh gọi lại cho khả năng tạm dừng và tiếp tục trên nhiều nền tảng.

  • Trò chơi PHẢI tạm dừng mọi hoạt động thực thi sau khi onPause được gọi và PHẢI tiếp tục thực thi chỉ khi onResume được gọi. Quá trình thực thi bao gồm tất cả các chức năng của Playable, chẳng hạn như vòng lặp trò chơi, nhạc, hoạt động tương tác, lệnh gọi mạng và kết xuất.
  • Trò chơi KHÔNG ĐƯỢC sử dụng Page Visibility API trên web hoặc các API web tương tự và CHỈ ĐƯỢC sử dụng Playables SDK onPause và onResume.
  • Trò chơi PHẢI lưu tiến trình của người dùng khi onPause xảy ra.