Historia zmian

Na tej stronie znajdziesz historię zmian tych dokumentów:

16 października 2026 r.

  • Zaktualizowaliśmy wymagania dotyczące zarabiania, aby poinformować, że nieprzestrzeganie ich może skutkować wyłączeniem funkcji zarabiania. Dodaliśmy też wymagania dotyczące nagród pieniężnych w świecie rzeczywistym (sekcja 1), reklam z nagrodą (sekcja 2.1), reklam pełnoekranowych (sekcja 2.2) i treści odpowiednich do wyświetlania reklam (sekcja 4).

25 sierpnia 2026 r.

  • Zaktualizowaliśmy wymagania dotyczące zaufania i bezpieczeństwa, aby dodać zasady dotyczące powielonych treści (sekcja 2.2), które wymagają oryginalnych, autoryzowanych lub licencjonowanych treści i zabraniają powielania kompilacji gier.

24 sierpnia 2026 r.

  • Dodaliśmy tagi ułatwień dostępu w grach (sekcje 2 i 2.1) dotyczące wykrywania graczy w ramach Accessible Gaming Initiative (AGI) i dokładności metadanych dewelopera.

11 lipca 2024 r.

  • Wymagania techniczne zostały podzielone na kilka stron.
  • Czyszczenie i usuwanie duplikatów wymagań.

24 czerwca 2024 r.

Zwiększono limit łącznego rozmiaru pakietu ze 100 MiB do 250 MiB i dodano wskazówki dotyczące leniwego ładowania.

17 czerwca 2024 r.

Aktualizacje zestawu testów:

  • Gry nie muszą już być wyświetlane przez HTTPS i mogą być wyświetlane z localhost na potrzeby testów.
  • Obok pola adresu URL dodano przycisk odświeżania, który umożliwia odświeżenie zawartości elementu iframe bez ponownego wczytywania całego zestawu testów.

16 maja 2024 r.

Przenieś sprawdzone metody projektowania do osobnego dokumentu, aby lepiej rozróżnić wymagania projektowe i sprawdzone metody.

8 maja 2024 r.

Przebudowaliśmy witrynę dla deweloperów Playables, aby ułatwić dostęp i poprawić nawigację.

7 maja 2024 r.

Zaktualizowaliśmy wymagania techniczne dotyczące powiadomienia o gotowości do gry, dodając szczegółowe informacje o wywołaniu firstFrameReady.

3 maja 2024 r.

  • Utworzono archiwum poprzednich wersji wymagań.

5 marca 2024 r.

Zwiększyliśmy limit rozmiaru pojedynczego pliku z 10 MiB do 30 MiB.

23 lutego 2024 r.

Dodano wartość logiczną IN_PLAYABLES_ENV do przestrzeni nazw najwyższego poziomu, aby informować deweloperów, kiedy ich gra działa w środowisku Pokoju gier.

4 grudnia 2023 r.

Aktualizacje zestawu testów

  • Dodano sprawdzanie nieobsługiwanych znaków w nazwach plików.
  • Dodano funkcję symulowania ekranu wczytywania, w tym ustawianie początkowej wysokości elementu iframe na 0.
  • Zaktualizowaliśmy przycisk wstrzymywania i wznawiania, aby bardziej przypominał wersję produkcyjną, przez przełączanie dźwięku podczas wstrzymywania i wznawiania.
  • Usunięto wiadomości, które nie wymagają działania, z dziennika zdarzeń.

10 listopada 2023 r.

Pakiet Test Suite do pobrania został zastąpiony hostowanym pakietem Test Suite.

Plik definicji typów TypeScript, który wcześniej był dostępny w zestawie testów, został przeniesiony do głównego artykułu o pakiecie SDK Pokoju gier.

7 września 2023 r.

Zaktualizowaliśmy sekcję Pierwsze kroki, aby zmienić adres URL pakietu SDK gier Playables z v0 na v1.

30 sierpnia 2023 r.

Zaktualizowaliśmy sekcje Nazwy plików i Miniatury, aby usunąć odniesienia do listy dozwolonych znaków specjalnych (_, -, .).

Zaktualizowaliśmy też sekcję Cloud Save, aby wymagać, żeby Cloud Save działało w nowych wersjach gry.

25 sierpnia 2023 r.

Sekcja saveData została zaktualizowana, aby wyjaśnić, że zapisane dane muszą być prawidłowym i dobrze sformułowanym ciągiem znaków UTF-16.

18 sierpnia 2023 r.

Zaktualizowaliśmy sekcję Wstrzymywanie i wznawianie, aby wyjaśnić, że gra musi wstrzymać wszystkie działania po wywołaniu onPause i wznowić je dopiero po wywołaniu onResume.

11 sierpnia 2023 r.

Dodano sekcję Nazwy plików, która zawiera informacje o limitach znaków w nazwach plików w pakiecie gry.

10 sierpnia 2023 r.

Zaktualizowaliśmy sekcję Metody interakcji, aby wymagać, żeby wszystkie komponenty interfejsu gry działały zgodnie z przeznaczeniem i bez błędów lub nieoczekiwanych zachowań.

9 sierpnia 2023 r.

Dodaliśmy sekcję Miniatury, w której wymieniliśmy wymagania dotyczące miniatur gier, dzięki którym użytkownicy mogą łatwo odkrywać i rozpoznawać gry z Pokoju gier na YouTube.

8 sierpnia 2023 r.

Sekcja Gesty i wprowadzanie danych została zaktualizowana, aby uniemożliwić grze wywoływanie metody preventDefault() w przypadku zdarzeń Esc.

Dodaliśmy też nową sekcję Odwołania do plików, aby wymagać od gier używania tylko ścieżek względnych podczas odwoływania się do innych plików w pakiecie, ponieważ używanie ścieżek bezwzględnych może powodować błędy.

2 sierpnia 2023 r.

Sekcja dotycząca wyciszania zarówno w Wymaganiach technicznych, jak i Wytycznych dotyczących projektowania gier Playables została zaktualizowana, aby odnosiła się do funkcji wyciszania i wyłączania wyciszenia jako elementów sterujących dźwiękiem oraz aby wskazywała, że szczegółowe elementy sterujące dźwiękiem mogą zawierać suwaki głośności lub przełącznik wyciszenia albo oba te elementy.

28 lipca 2023 r.

Zaktualizowaliśmy dokumentację Wytyczne dotyczące projektowania gier Playables, aby ujednolicić sformułowania oraz zaktualizować sprawdzone metody i zrzuty ekranu.

20 lipca 2023 r.

Dodaliśmy sekcję Wstrzymywanie i wznawianie, aby umożliwić wstrzymywanie i wznawianie na wielu platformach.

19 lipca 2023 r.

Witryna Pokoju gier na YouTube zawiera teraz dokumentację Wytyczne dotyczące projektowania gier w Pokoju gier, która służy jako przewodnik po zapewnianiu optymalnych wrażeń użytkownikom grającym w gry na YouTube na różnych urządzeniach i platformach.

Wskazówki dotyczące projektowania gier skupiają się na tych obszarach:

  • obrazy miniatur,
  • Dostosowanie do urządzenia
  • Interfejs użytkownika
  • Gesty i wprowadzanie danych
  • Wstrzymaj
  • Wycisz
  • Reakcja haptyczna
  • Wprowadzenie użytkownika
  • Koniec gry (ekran wygranej)
  • Ułatwienia dostępu

Dodatkowo zaktualizowaliśmy sekcję onAudioEnabledChange, aby poprawić niewielki błąd typograficzny w kodzie, który powodował błąd w proponowanej przez Flutter warstwie interoperacyjności JavaScriptu (JS-Interop).

14 lipca 2023 r.

Sekcja Rozmiar została zaktualizowana w ten sposób:

  • Usunęliśmy wymaganie, zgodnie z którym gra musi być grywalna na pełnym ekranie na komputerze oraz w orientacji poziomej lub pionowej na urządzeniu mobilnym.
  • Dodaliśmy informację, że gra musi być grywalna w orientacji pionowej.
  • Dodaliśmy informację, że gra powinna być dostępna w trybie poziomym. W przeciwnym razie gra musi być wyśrodkowana lub zawierać czarne pasy po bokach.
  • Dodaliśmy informację, że gra nie może blokować orientacji urządzenia.

11 lipca 2023 r.

Dodaliśmy sekcję Flutter Web (eksperymentalna), aby umożliwić integrację z grami napisanymi we Flutter Web.

1 lipca 2023 r.

Sekcja Przełącznik wyciszenia wymaga, aby gra uwzględniała ustawienia dźwięku zarówno YouTube, jak i systemu, a dźwięk gry nie powinien odtwarzać się nieoczekiwanie.

Dodatkowo sekcja Zakończenie obsługi treści wyjaśnia, że gra musi poinformować użytkownika, że nie ma już treści, z którymi można wejść w interakcję, np. na ostatnim poziomie lub po ukończeniu gry.

30 czerwca 2023 r.

Sekcja Pierwsze kroki zawiera teraz informację, że pakiet SDK nie będzie działać, gdy gra będzie udostępniana lokalnie. Aby sprawdzić poprawność integracji pakietu SDK, zapoznaj się z zestawem testów SDK.

2 czerwca 2023 r.

Witryna Pokoju gier na YouTube zawiera teraz dokumentację pakietu SDK Pokoju gier, która obejmuje bogaty zestaw interfejsów API obsługujących gry na YouTube.

26 maja 2023 r.

Aktualizacje dokumentacji dotyczącej wymagań technicznych:

Sekcja Zmiany
Czas wczytywania Uwzględniono średnią szybkość internetu wynoszącą 6,8 Mb/s na całym świecie i 20 Mb/s w USA.
Metody interakcji Dodaliśmy informację, że gdy użytkownik wchodzi w interakcję z grą, gra nie może niezamierzenie opóźniać ani ignorować danych wejściowych.
Miniatury Zaktualizowaliśmy wymagane rozdzielczości obrazów w formatach 1:1, 5:7 i 16:9.
Informacje o wydawcy lub deweloperze Dodaliśmy nową sekcję, która wymaga, aby gra zawierała nazwę wydawcy lub dewelopera. W przyszłości może być też wymagane podanie oceny treści.
Wczytywanie pakietu SDK Playables Dodaliśmy nową sekcję, która wymaga, aby gra wczytywała pakiet SDK do gier Playables przed jakimkolwiek innym kodem gry.
Powiadomienie o gotowości gry Zaktualizowano, aby wywoływać interfejs API firstFrameReady tylko wtedy, gdy pierwsza klatka gry jest gotowa do renderowania na ekranie, i wywoływać interfejs API gameReady tylko wtedy, gdy gra jest gotowa na interakcję z użytkownikiem.
Przełącznik wyciszenia Dodaliśmy informację, że gdy YouTube jest wyciszony, dźwięk nie może być odtwarzany, a elementy sterujące wyciszaniem lub wyłączaniem wyciszenia w grze nie mogą wpływać na odtwarzanie dźwięku.

24 marca 2023 r.

Witryna Pokoju gier na YouTube zawiera teraz dokumentację dotyczącą wymagań technicznych, która ma na celu zapewnienie użytkownikom płynnej rozgrywki podczas grania w gry na YouTube.

Sekcja wymagań technicznych koncentruje się na tych obszarach:

  • Stabilność gry
  • Korzystanie z YouTube
  • Integracja z YouTube
  • Lokalizacja
  • Zarabianie