Nhật ký sửa đổi

Trang này cung cấp nhật ký sửa đổi cho các tài liệu sau:

Ngày 25 tháng 8 năm 2026

  • Cập nhật các yêu cầu về độ an toàn và tin cậy để bổ sung chính sách về nội dung trùng lặp (Mục 2.2) yêu cầu nội dung phải là nội dung gốc, được uỷ quyền hoặc được cấp phép và nghiêm cấm bản dựng trò chơi trùng lặp.

Ngày 24 tháng 8 năm 2026

  • Thêm thẻ hỗ trợ tiếp cận trò chơi (Mục 2 và 2.1) bao gồm hoạt động khám phá người chơi của Sáng kiến về khả năng tiếp cận trò chơi (AGI) và độ chính xác của siêu dữ liệu nhà phát triển.

Ngày 11 tháng 7 năm 2024

  • Tái cấu trúc các yêu cầu kỹ thuật thành nhiều trang.
  • Dọn dẹp và loại bỏ các yêu cầu trùng lặp.

Ngày 24 tháng 6 năm 2024

Tăng giới hạn tổng kích thước gói từ 100 MiB lên 250 MiB và thêm hướng dẫn tải từng phần.

Ngày 17 tháng 6 năm 2024

Thông tin cập nhật về Bộ thử nghiệm:

  • Giờ đây, các trò chơi không cần được phân phát qua HTTPS và có thể được phân phát từ localhost để thử nghiệm.
  • Đã thêm nút làm mới bên cạnh trường URL để làm mới nội dung của iframe mà không cần tải lại toàn bộ Bộ thử nghiệm.

Ngày 16/5/2024

Di chuyển các phương pháp hay nhất về thiết kế sang một tài liệu riêng để phân định rõ hơn giữa các yêu cầu về thiết kế và các phương pháp hay nhất.

Ngày 8 tháng 5 năm 2024

Tái cấu trúc trang web dành cho nhà phát triển Playables để mở rộng quyền truy cập và cải thiện khả năng điều hướng.

Ngày 7 tháng 5 năm 2024

Cập nhật Yêu cầu kỹ thuật cho Thông báo sẵn sàng chơi kèm theo thông tin chi tiết bổ sung cho lệnh gọi firstFrameReady.

Ngày 3 tháng 5 năm 2024

  • Tạo một kho lưu trữ các phiên bản yêu cầu trước đây.

Ngày 5 tháng 3 năm 2024

Tăng giới hạn kích thước tệp riêng lẻ từ 10 MiB lên 30 MiB.

Ngày 23 tháng 2 năm 2024

Đã thêm boolean IN_PLAYABLES_ENV vào không gian tên cấp cao nhất để cho nhà phát triển biết khi nào trò chơi của họ đang chạy trong môi trường Chơi game.

Ngày 4 tháng 12 năm 2023

Thông tin cập nhật về Bộ thử nghiệm

  • Đã thêm bước kiểm tra các ký tự không được hỗ trợ trong tên tệp.
    • Để biết thông tin về các ký tự được hỗ trợ, hãy xem phần Yêu cầu về kỹ thuật – 1.9 Tên tệp.
    • Hạn chế đã biết: Quy trình kiểm tra này có thể không xác thực tất cả các tài nguyên đã tải.
  • Thêm tính năng mô phỏng màn hình tải, bao gồm cả việc đặt chiều cao iframe ban đầu thành 0.
  • Cập nhật nút tạm dừng/tiếp tục để khớp với bản phát hành chính xác hơn bằng cách bật/tắt âm thanh khi tạm dừng và tiếp tục.
  • Xoá các thông báo không có hành động khỏi nhật ký sự kiện.

Ngày 10 tháng 11 năm 2023

Gói Bộ kiểm thử có thể tải xuống đã được thay thế bằng Bộ kiểm thử được lưu trữ.

Tệp định nghĩa kiểu TypeScript (trước đây có trong gói Test Suite) đã được chuyển sang bài viết chính về Playables SDK.

Ngày 7 tháng 9 năm 2023

Phần Bắt đầu đã được cập nhật để thay đổi URL Playables SDK từ v0 thành v1.

Ngày 30 tháng 8 năm 2023

Các phần Tên tệp và Hình thu nhỏ đã được cập nhật để xoá các nội dung tham chiếu nhằm liệt kê rõ ràng các ký tự đặc biệt được phép (_, -, .).

Ngoài ra, phần Lưu vào đám mây đã được cập nhật để yêu cầu chức năng lưu vào đám mây hoạt động trong các phiên bản trò chơi mới.

Ngày 25 tháng 8 năm 2023

Phần saveData đã được cập nhật để làm rõ rằng dữ liệu đã lưu phải là một chuỗi UTF-16 hợp lệ và có cấu trúc rõ ràng.

Ngày 18 tháng 8 năm 2023

Phần Tạm dừng và tiếp tục đã được cập nhật để làm rõ rằng trò chơi phải tạm dừng tất cả các hoạt động thực thi sau khi onPause được gọi và chỉ tiếp tục khi onResume được gọi.

Ngày 11 tháng 8 năm 2023

Phần Tên tệp đã được thêm vào để đưa ra các giới hạn về ký tự dùng để đặt tên cho tệp trong gói trò chơi.

Ngày 10 tháng 8 năm 2023

Phần Phương thức tương tác đã được cập nhật để yêu cầu tất cả các thành phần giao diện người dùng của một trò chơi hoạt động như dự kiến và không có lỗi hoặc hành vi không mong muốn.

Ngày 9 tháng 8 năm 2023

Phần Hình thu nhỏ đã được thêm vào để liệt kê các yêu cầu về hình thu nhỏ của trò chơi, giúp người dùng dễ dàng khám phá và nhận ra một trò chơi có thể chơi trên YouTube.

Ngày 8 tháng 8 năm 2023

Phần Cử chỉ và thao tác nhập đã được cập nhật để cấm trò chơi gọi preventDefault() trên các sự kiện Esc.

Ngoài ra, chúng tôi đã thêm một phần Tham chiếu tệp mới để yêu cầu các trò chơi chỉ sử dụng đường dẫn tương đối khi tham chiếu đến các tệp khác trong gói vì việc sử dụng đường dẫn tuyệt đối có thể gây ra lỗi.

Ngày 2 tháng 8 năm 2023

Phần Tắt tiếng trong cả Yêu cầu kỹ thuật và Nguyên tắc thiết kế trò chơi có thể chơi đã được cập nhật để đề cập đến các tính năng tắt tiếng và bật tiếng dưới dạng nút điều khiển âm thanh, đồng thời cho biết rằng các nút điều khiển âm thanh chi tiết có thể chứa thanh trượt âm lượng hoặc nút bật/tắt tiếng hoặc cả hai.

Ngày 28 tháng 7 năm 2023

Tài liệu Nguyên tắc thiết kế trò chơi có thể chơi đã được cập nhật để chuẩn hoá cách diễn đạt, đồng thời cập nhật các phương pháp hay nhất và ảnh chụp màn hình.

Ngày 20 tháng 7 năm 2023

Phần Tạm dừng và tiếp tục đã được thêm vào để cung cấp các chức năng tạm dừng và tiếp tục trên nhiều nền tảng.

Ngày 19 tháng 7 năm 2023

Giờ đây, trang web Chơi game trên YouTube có thêm tài liệu Nguyên tắc thiết kế trò chơi Chơi game để hướng dẫn cách mang đến trải nghiệm chơi game tối ưu cho người dùng chơi trò chơi trên YouTube trên nhiều thiết bị và nền tảng.

Nguyên tắc thiết kế trò chơi tập trung vào những khía cạnh sau:

  • Hình thu nhỏ
  • Thích ứng với thiết bị
  • Giao diện người dùng (UI)
  • Cử chỉ và phương thức nhập
  • Tạm dừng
  • Tắt tiếng
  • Phản hồi xúc giác
  • Quy trình làm quen của người dùng
  • Trận đấu kết thúc (màn hình chiến thắng)
  • Hỗ trợ tiếp cận

Ngoài ra, phần onAudioEnabledChange đã được cập nhật để khắc phục một lỗi chính tả nhỏ trên mã, gây ra lỗi trong lớp khả năng tương tác JavaScript (JS-Interop) được đề xuất của Flutter.

Ngày 14 tháng 7 năm 2023

Mục Kích thước đã được cập nhật như sau:

  • Xoá yêu cầu rằng trò chơi phải chơi được ở chế độ toàn màn hình trên máy tính và ở chế độ ngang hoặc dọc trên thiết bị di động.
  • Thêm yêu cầu rằng trò chơi phải chơi được ở chế độ dọc.
  • Thêm yêu cầu rằng trò chơi phải chơi được ở chế độ ngang. Nếu không, trò chơi phải được đặt ở giữa hoặc phải có hiệu ứng hòm thư.
  • Thêm yêu cầu rằng trò chơi không được khoá hướng thiết bị.

Ngày 11 tháng 7 năm 2023

Phần Flutter web (thử nghiệm) đã được thêm để cho phép tích hợp với các trò chơi được viết bằng Flutter Web.

Ngày 1 tháng 7 năm 2023

Mục Nút bật/tắt tiếng yêu cầu trò chơi tuân thủ chế độ cài đặt âm thanh của cả YouTube và hệ thống, đồng thời âm thanh của trò chơi không được phát một cách bất ngờ.

Ngoài ra, phần Hoàn tất việc xử lý nội dung làm rõ rằng trò chơi phải thông báo cho người dùng rằng không còn nội dung nào để tương tác, chẳng hạn như ở cấp độ cuối cùng hoặc khi hoàn tất trò chơi.

Ngày 30 tháng 6 năm 2023

Phần Bắt đầu hiện có một lưu ý rằng SDK sẽ không hoạt động khi trò chơi được phân phát cục bộ. Để xác minh tính chính xác của việc tích hợp SDK, hãy xem Bộ thử nghiệm SDK.

Ngày 2 tháng 6 năm 2023

Giờ đây, trang web YouTube Chơi game có tài liệu về Playables SDK, trong đó có một bộ API mạnh mẽ để hỗ trợ các trò chơi trên YouTube.

Ngày 26 tháng 5 năm 2023

Sau đây là nội dung cập nhật trong tài liệu Yêu cầu về kỹ thuật:

Phần Các thay đổi
Thời gian tải Bao gồm tốc độ Internet trung bình là 6,8 Mb/giây trên toàn thế giới và 20 Mb/giây đối với Hoa Kỳ.
Phương thức tương tác Thêm quy định rằng khi người dùng tương tác với trò chơi, trò chơi không được vô tình trì hoãn hoặc bỏ qua dữ liệu đầu vào.
Hình thu nhỏ Cập nhật độ phân giải hình ảnh bắt buộc cho tỷ lệ 1:1, 5:7 và 16:9.
Thông tin về nhà xuất bản hoặc nhà phát triển Thêm phần mới này, yêu cầu trò chơi phải có tên của nhà xuất bản hoặc nhà phát triển và cũng có thể phải cung cấp mức phân loại nội dung trong tương lai.
Tải Playables SDK Thêm phần mới này, yêu cầu trò chơi tải Playables SDK trước bất kỳ mã trò chơi nào khác.
Thông báo sẵn sàng chơi Đã cập nhật để chỉ gọi API firstFrameReady khi khung hình đầu tiên của trò chơi đã sẵn sàng hiển thị trên màn hình và chỉ gọi API gameReady khi trò chơi đã sẵn sàng cho mọi hoạt động tương tác của người dùng.
Nút bật/tắt tiếng Thêm quy định rằng khi chế độ tắt tiếng trên YouTube được bật, âm thanh không được phát và chế độ tắt tiếng hoặc bật tiếng của trò chơi không được ảnh hưởng đến đầu ra âm thanh.

Ngày 24 tháng 3 năm 2023

Trang web Chơi game trên YouTube hiện có tài liệu Yêu cầu kỹ thuật nhằm mang đến trải nghiệm chơi game mượt mà cho người dùng chơi game trên YouTube.

Phần yêu cầu về kỹ thuật tập trung vào các khía cạnh sau:

  • Độ ổn định của trò chơi
  • Trải nghiệm trên YouTube
  • Tích hợp với YouTube
  • Bản địa hoá
  • Kiếm tiền