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 SDK Chơi game.

1 SDK Chơi game tải

Thông báo 2 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ột màn hình tải hoặc màn hình chờ thông báo rõ ràng cho người dùng rằng quá trình tải đang diễn ra.
  • Trò chơi PHẢI gọi gameReady và PHẢI gọi chỉ gameReady khi trò chơi đã sẵn sàng để người dùng tương tác (ví dụ: trình đơn chính hoặc trò chơi đã sẵn sàng để phát).
  • Trò chơi KHÔNG ĐƯỢC gọi gameReady trong khi vẫn có những lệnh gọi không tương tác được các phần tử được hiển thị cho người dùng (ví dụ: màn hình chờ hoặc màn hình tải màn hình).

YouTube 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 sử dụng sendScore để gửi điểm số, thì trò chơi PHẢI tuân thủ thông số 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 trò chơi lưu.

4 lượt lưu vào đám mây

  • PHẢI gọi saveData cho trò chơi để lưu tiến trình khi người dùng đã thực hiện tiến trình chơi Material (ví dụ: thay đổi cấp độ) trong đó trò chơi khiến người dùng tin rằng tiến trình của họ đã được lưu lại.
  • 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. Chiến dịch này cho phép người chơi tiếp tục trò chơi sau đó.
  • Trò chơi PHẢI đợi loadData rồi mới gọi saveData. Nếu saveData được gọi trước khi loadData hoàn tất thành công, phương thức sẽ bị từ chối. Điều này ngăn trò chơi ghi đè bất kỳ dữ liệu đã lưu trước đó.
  • Trò chơi PHẢI có thể sử dụng dữ liệu lưu vào đám mây từ các phiên bản trước của mà không gặp lỗi hoặc sự cố.
  • Trò chơi NÊN sử dụng dữ liệu lưu vào đám mây để duy trì tiến trình của người dùng trên tất cả phiên bản trò chơi mà trong đó người dùng muốn dữ liệu của họ được sử dụng.
  • Trò chơi NÊN tự động lưu tiến trình của người dùng vào trò chơi quan trọng để ngăn chặn mất dữ liệu. Lần lưu xả cuối cùng được thực hiện khi người dùng thoát khỏi trò chơi nhưng cố gắng hết sức và chỉ có thể tiết kiệm tối đa 64 KiB nội dung thời lượng.

5 Nút bật/tắt tiếng

  • Trò chơi PHẢI tuân thủ chế độ cài đặt âm thanh của hệ thống và nút tắt tiếng.
  • Trò chơi PHẢI tôn trọng chế độ cài đặt âm thanh và nút tắt tiếng của YouTube bằng cách sử dụng isAudioEnabled và onAudioEnabledChange.
  • Trò chơi PHẢI tuân thủ chế độ điều chỉnh âm lượng trên thiết bị.
  • Âm thanh của trò chơi KHÔNG ĐƯỢC phát đột ngột.
  • Khi bạn đặt chế độ tắt tiếng YouTube, KHÔNG ĐƯỢC phát âm thanh và âm thanh trò chơi các nút điều khiển KHÔNG ĐƯỢC ảnh hưởng đến đầu ra âm thanh.
  • Khi bạn không đặt chế độ tắt tiếng trên YouTube, các nút điều khiển âm thanh của trò chơi CÓ THỂ ảnh hưởng đến âm thanh đầu ra.
  • Trò chơi KHÔNG ĐƯỢC 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 để làm việc này.
  • Trò chơi MAY có các nút điều khiển âm thanh chi tiết riêng biệt trong trò chơi, chẳng hạn như cho nhạc và hiệu ứng âm thanh, nhưng chúng PHẢI tuân theo tất cả các chế độ điều khiển âm thanh khác các yêu cầu liên quan.

Các chế độ cài đặt âm thanh khác nhau cho nền, sfx, hộp thoại

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

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

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