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 16 tháng 10 năm 2026

  • Cập nhật Yêu cầu về việc kiếm tiền để lưu ý rằng việc không tuân thủ các yêu cầu này có thể khiến các tính năng kiếm tiền bị tắt, đồng thời bổ sung các yêu cầu về phần thưởng bằng tiền thật (Mục 1), quảng cáo có tặng thưởng (Mục 2.1), quảng cáo xen kẽ (Mục 2.2) và nội dung phù hợp với nhà quảng cáo (Mục 4).

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

  • Cập nhật Yêu cầu về sự tin cậy và an toàn để thêm chính sách về nội dung trùng lặp (Mục 2.2) yêu cầu nội dung gốc, được uỷ quyền hoặc được cấp phép và cấm các 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 trong trò chơi (Mục 2 và 2.1) về khả năng khám phá của người chơi trong Sáng kiến hỗ trợ tiếp cận trong trò chơi (AGI) và độ chính xác của siêu dữ liệu của 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 về kỹ thuật thành nhiều trang.
  • Dọn dẹp và loại bỏ trùng lặp các yêu cầu.

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

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

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

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

  • Trò chơi không cần phải được phân phát qua HTTPS nữa 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ộ kiểm thử.

Ngày 16/5/2024

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 thiết kế và các phương pháp hay nhất.

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

Cải tiến 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 về kỹ thuật cho Thông báo trò chơi đã sẵn sàng, bổ sung thông tin chi tiết cho lệnh gọi firstFrameReady.

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

  • Tạo bản 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ộ kiểm thử

  • Đã thêm tính năng 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.
    • Giới hạn đã biết: Quy trình kiểm tra này có thể không xác thực được tất 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 để phù hợp hơn với phiên bản chính thức bằng cách bật/tắt âm thanh khi tạm dừng và tiếp tục.
  • Đã xóa các thông báo không thể thực hiện hành động khỏi tính năng ghi 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 Bộ kiểm thử) đã được chuyển sang bài viết chính về SDK Game có thể chơi.

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

Mục Bắt đầu đã được cập nhật để thay đổi URL SDK của Playables 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á nội dung đề cập đến việc liệt kê rõ ràng các ký tự đặc biệt được phép (_, -, .).

Ngoài ra, mục Lưu vào đám mây đã được cập nhật để yêu cầu tính 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

Mục 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à đúng định dạng.

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

Mục 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 mọi hoạt động thực thi sau khi onPause được gọi và chỉ tiếp tục sau 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 để bao gồm các giới hạn về ký tự dùng để đặt tên tệp trong gói trò chơi.

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

Mục Phương thức tương tác đã được cập nhật để yêu cầu tất cả thành phần giao diện người dùng của trò chơi phải hoạt động như dự kiến và không có lỗi hoặc hành vi ngoài dự kiế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 được trên YouTube.

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

Mục Cử chỉ và hoạt động đầu vào đã được cập nhật để cấm trò chơi gọi preventDefault() cho các sự kiện Esc.

Ngoài ra, chúng tôi đã thêm một phần mới là Tham chiếu tệp để yêu cầu 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

Mục Tắt tiếng trong cả Yêu cầu về kỹ thuật và Nguyên tắc thiết kế trò chơi có thể chơi được đã đượ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 chế độ kiểm soát âm thanh, đồng thời cho biết rằng các chế độ kiểm soát â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

Mục 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

Trang web Chơi game trên YouTube hiện có tài liệu Nguyên tắc thiết kế trò chơi cho tính năng Chơi game trên YouTube để hướng dẫn cách mang đến trải nghiệm chơi trò chơi 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 các khía cạnh sau:

  • Hình thu nhỏ
  • Điều chỉnh 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
  • Giới thiệu cho người dùng
  • Kết thúc trò chơi (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 để sửa một lỗi đánh máy nhỏ trong 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:

  • Đã xóa yêu cầu về việc 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.
  • Bổ sung yêu cầu trò chơi phải chơi được ở chế độ dọc.
  • Bổ sung thông tin rằng trò chơi phải chơi được ở chế độ ngang. Nếu không, trò chơi phải được căn giữa hoặc phải có hộp đen dọc.
  • Bổ sung yêu cầu trò chơi không được khoá hướng thiết bị.

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

Mục Flutter web (thử nghiệm) đã được thêm vào để 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

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

Ngoài ra, mục 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 biết 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 thành trò chơi.

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

Mục Bắt đầu hiện có thêm 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ộ kiểm thử SDK.

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

Trang web Chơi game trên YouTube hiện có tài liệu về SDK Chơi game, 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 cho tài liệu về Yêu cầu 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 cho 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 hoạt động đầ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 mục mới này yêu cầu trò chơi phải bao gồm 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 SDK Playables Thêm phần mới này, yêu cầu trò chơi tải SDK Playables trước bất kỳ mã trò chơi nào khác.
Thông báo trò chơi đã sẵn sàng 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 hoặc tắt tiếng Thêm yêu cầu rằng khi YouTube được đặt ở chế độ tắt tiếng, âm thanh không được phát ra và các chế độ điều khiển 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 về 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 YouTube
  • Bản địa hoá
  • Kiếm tiền