# Co PlayDrop dodaje do twojej gry

Co gra PlayDrop może robić dzięki SDK, catalogue.json i hostingowi, gdzie działa każda funkcja i gdzie ją opisano: zapisy, rankingi, grupy, serwery i więcej.

Source: https://www.playdrop.ai/pl/create/learn/playdrop-games

Gra PlayDrop to gra webowa, którą PlayDrop hostuje, pokazuje na listach i uruchamia na swojej stronie internetowej oraz w aplikacjach PlayDrop na iOS, Androida, Windows i macOS. W aplikacjach gra działa na pełnym ekranie, bez paska przeglądarki; to ta sama gra webowa uruchomiona w widoku gry aplikacji, a nie osobna wersja natywna. Ta strona wymienia, co PlayDrop może dodać i gdzie opisano każdą część.

## Dwie drogi

| | Prosty HTML | Pakiet |
|---|---|---|
| Co wysyłasz | Jeden samodzielny plik HTML, do 10 MiB | Zbudowany folder, ZIP lub .play z catalogue.json |
| PlayDrop SDK | Nie | Tak, każda funkcja poniżej |
| Obrazy i wideo strony gry | Nie | Tak |
| Hostowany serwer gry | Nie | Tak |
| Poradnik | [Proste gry HTML](https://www.playdrop.ai/pl/create/learn/html-games) | [Pakowanie](https://www.playdrop.ai/pl/create/learn/packaging) |

Każda gra może zacząć jako prosta, a później stać się pakietem pod tą samą nazwą i linkiem.

## Co dostają gracze

| Możliwość | Co daje graczom | Poradnik |
|---|---|---|
| Cykl życia hosta | Płynna pauza i wznowienie, dźwięk zgodny z wyciszeniem gracza, szybka pierwsza klatka | [Ładowanie, pauza i dźwięk](https://www.playdrop.ai/pl/create/learn/lifecycle) |
| Układ pełnoekranowy | Gra od krawędzi do krawędzi, z interfejsem z dala od wcięć ekranu i przycisków PlayDrop | [Pełny ekran i bezpieczne obszary](https://www.playdrop.ai/pl/create/learn/viewport) |
| Zapisy w chmurze | Postępy, które idą za graczem między urządzeniami | [Zapisy w chmurze](https://www.playdrop.ai/pl/create/learn/cloud-saves) |
| Rankingi | Najlepsze wyniki i pozycja gracza | [Rankingi](https://www.playdrop.ai/pl/create/learn/leaderboards) |
| Osiągnięcia | Cele z ikonami i postępem | [Osiągnięcia](https://www.playdrop.ai/pl/create/learn/achievements) |
| Udostępnianie i zaproszenia | Udostępnianie z obrazem lub klipem, zaproszenia dla znajomych i karty gier na czacie | [Udostępnianie, znajomi i zaproszenia](https://www.playdrop.ai/pl/create/learn/social) |
| Grupy online i głos | Znajomi razem dołączają do tego samego pokoju, z opcjonalnym głosem pokoju | [Grupy online i głos](https://www.playdrop.ai/pl/create/learn/online-party) |
| Grupy lokalne i kontrolery | Gamepady i telefony jako kontrolery na jednym ekranie | [Grupy lokalne i kontrolery](https://www.playdrop.ai/pl/create/learn/local-party) |
| Serwery czasu rzeczywistego | Pokoje Colyseus z bazą danych MongoDB dla każdej gry | [Serwery gier czasu rzeczywistego](https://www.playdrop.ai/pl/create/learn/game-servers) |
| Recenzje, napiwki, zakupy i reklamy | Sposoby, w jakie gracze mogą wspierać grę; kredyty dla twórcy | [Zarabianie](https://www.playdrop.ai/pl/create/learn/monetization) |
| Zasoby i generowanie z AI | Wspólne zasoby, generowane multimedia i dzieła graczy | [Zasoby gry](https://www.playdrop.ai/pl/create/learn/game-assets), [Zasoby z AI](https://www.playdrop.ai/pl/create/learn/ai-assets), [Własne formaty](https://www.playdrop.ai/pl/create/learn/custom-assets) |

## Co dostaje strona gry

catalogue.json daje grze jej stronę: tytuł, opis, gatunek i [tagi](https://www.playdrop.ai/pl/create/learn/tags), [ikonę, grafikę główną, zrzuty ekranu i wideo](https://www.playdrop.ai/pl/create/learn/listing-assets), [tłumaczenia](https://www.playdrop.ai/pl/create/learn/localization) oraz kwalifikowalność do [Instant](https://www.playdrop.ai/pl/create/learn/instant-games). [Widoczność](https://www.playdrop.ai/pl/create/learn/distribution) decyduje, kto może ją otworzyć: prywatna do testów, niepubliczna dla każdego z linkiem, publiczna do odkrywania w PlayDrop i otwarta dla wyszukiwarek. Publiczna strona gry daje szansę na odkrycie; nie gwarantuje graczy.

## Gdzie działa każda funkcja

Strona internetowa i aplikacje uruchamiają tę samą grę z tym samym SDK, ale niektóre funkcje hosta zależą od urządzenia:

- Wibracje działają tylko w aplikacjach natywnych; `sdk.haptics.supported` ci to powie.
- Udostępnianie klipu wideo zależy od hosta; hosty bez tej funkcji odrzucają wywołanie, zamiast udostępnić sam link.
- Gra offline i wstępne ładowanie plików działają w aplikacjach natywnych w grach, które je deklarują; strona internetowa ładuje gry online.
- Głos pokoju i grupy zależą od wersji hosta, logowania i wdrożenia na platformie.
- Reklamy zależą od hosta i dostępnych reklam; `load()` zgłasza, gdy żadna nie jest gotowa.

Projektuj tak, aby gra działała dalej, gdy brakuje opcjonalnej usługi.

## Zacznij od SDK

Załaduj SDK, odczytaj stan hosta, a potem zgłoś gotowość, gdy pierwsza zaprojektowana klatka jest na ekranie:

```html
<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
  const sdk = await playdrop.init();
  // Set up pause, audio and HUD from sdk.host, then render the first frame.
  sdk.host.ready();
</script>
```

Kontynuuj z poradnikiem [ładowanie, pauza i dźwięk](https://www.playdrop.ai/pl/create/learn/lifecycle). [Dokumentacja SDK klienta](https://www.playdrop.ai/pl/create/learn/sdk) wymienia wszystkie przestrzenie nazw.

## Czego konektor nie potrafi

Twoja aplikacja AI publikuje zbudowane gry i odczytuje twoje konto. Nie może otwierać ani zmieniać gier stworzonych w Studio PlayDrop, zwracać kodu źródłowego ani przesyłać wykonywalnego kodu modeli 3D. To ograniczenia konektora, a nie platformy: Studio i własne narzędzia PlayDrop nadal to potrafią.

## Powiązane poradniki

- [Proste gry HTML](https://www.playdrop.ai/pl/create/learn/html-games): Opublikuj jeden samodzielny plik HTML do 10 MiB przez upload_game: co się mieści, mini katalog, widoczność, aktualizacje i kiedy przejść na pakiet.
- [Pakowanie i .play](https://www.playdrop.ai/pl/create/learn/packaging): Zbudowana gra w folderze, ZIP lub .play z catalogue.json w katalogu głównym: media strony gry, serwery i przesyłanie przez prepare_catalogue_upload.
- [Ładowanie, pauza i dźwięk](https://www.playdrop.ai/pl/create/learn/lifecycle): Zainicjuj SDK, zgłoś gotowość przy pierwszej grywalnej klatce, wstrzymuj i wznawiaj grę, przestrzegaj zasad dźwięku i wstępnie ładuj pliki do gry offline.
- [SDK klienta](https://www.playdrop.ai/pl/create/learn/sdk): SDK PlayDrop w przeglądarce: cykl życia hosta, gracz i zapisy, kontrolery, funkcje społecznościowe, gra wieloosobowa, sklep, reklamy, rankingi, zasoby i AI.