Áttekintés

A Steam HTML Felület API lehetővé teszi HTML-alapú oldalak összeállítását és megjelenítését közvetlenül egy játékban vagy alkalmazásban. A Chromium Embedded Frameworkre épül, és támogatja a HTML5 jelölést.

Első lépések az iSteamHtmlSurface-szel

Az ISteamHTMLSurface interfész az isteamhtmlsurface.h-ban van implementálva, és a Steamworks SDK public/steam mappájában található. Az interfész a SteamHTMLSurface() interfészmutatón keresztül érhető el.
Alább található az API-ban leggyakrabban használt metódusok listája. A weboldallal történő interakcióval (görgetés, hivatkozásra kattintás), Javascript-használattal, fájl-párbeszédablakokkal stb. kapcsolatos részletekért fordulj az API referenciájához.

• ISteamHTMLSurface::Init
  Gondoskodj az Init meghívásáról, mielőtt bármilyen módon használnád ezt az interfészt.
  
• ISteamHTMLSurface::Shutdown
  Gondoskodj a Shutdown meghívásáról, amikor már nem használod tovább ezt az interfészt.
  
• ISteamHTMLSurface::CreateBrowser
  Ez a függvény létrehoz egy böngészőobjektumot egy HTML-oldal megjelenítéséhez, és egy ISteamHTMLSurface::HTML_BrowserReady_t leírót ad vissza a létrehozott böngészőre, amely ezután használható az ::OnBrowserReady egy CallResult-jához.
  
• ISteamHTMLSurface::RemoveBrowser
  Hívd meg ezt, amikor végeztél egy HTML felülettel. Felszabadítja az általa használt erőforrásokat.
  
• ISteamHTMLSurface::SetSize
  Hívd meg ezt a HTML-megjelenítési terület méretének beállításához.
  
• ISteamHTMLSurface::LoadURL
  A megadott URL felkeresése. ISteamHTMLSurface::HTML_StartRequest_t-t eredményez, amikor a kérés megkezdődik.
  
• ISteamHTMLSurface::AllowStartRequest
  Ezt meg kell hívnod válaszként egy ISteamHTMLSurface::HTML_StartRequest_t callbackre.

Callback-beállítás

Van egy sor callback, amelyek beállíthatók annak megállapítására, mikor történnek meg bizonyos böngészőesemények (a teljes listáért lásd a isteamhtmlsurface.h-t). A Steamworks példa bemutatja e callbackek némelyikének megvalósítását és használatát a htmlsurface.h/.cpp-ben.
Egy egyszerű HTML felület megvalósítás befejezéséhez callbacket kell megvalósítani az ISteamHTMLSurface::HTML_NeedsPaint_t-hez a megjelenítendő képadatok lekérdezésére.

Steamworks példa megvalósítás

Az SDK-val együtt szállított Steamworks API Example Application (SpaceWar) tartalmaz egy alapszintű megvalósítást a Steam HTML Felület API-hoz. A minta elindításakor görgess le, és válaszd a HTML oldalt. Ekkor be fog töltődni a Steam Közösség kezdőoldala a játékban.
A Steam HTML Felület API integrálását a htmlsurface.h és htmlsurface.cpp fájlokban találod.
MEGJEGYZÉS: a weboldallal való interakció jelenleg nincs megvalósítva a példában.