Введение

API HTML Surface позволяет отображать основанные на HTML страницы прямо в игре или в приложении. Он построен на Chromium Embedded Framework и поддерживает разметку HTML5.

Начало работы с ISteamHTMLSurface

Интерфейс ISteamHTMLSurface внедрён в isteamhtmlsurface.h и находится в папке public/steam в SDK Steamworks. Доступ к интерфейсу осуществляется с помощью указателя SteamHTMLSurface().
Далее приведён список наиболее часто используемых методов этого API. Детальное описание взаимодействия с веб-страницами, использования Javascript, работы диалогового окна выбора файлов и проч. доступно в справочнике по API.

• ISteamHTMLSurface::Init
  Init нужно обязательно вызвать до начала использования этого интерфейса.
  
• ISteamHTMLSurface::Shutdown
  Вызов Shutdown обязателен, когда интерфейс более не используется.
  
• ISteamHTMLSurface::CreateBrowser
  Этот вызов создаёт объект браузера для отображения HTML-страницы и возвращает созданному браузеру дескриптор ISteamHTMLSurface::HTML_BrowserReady_t, который впоследствии может быть использован в результате вызова для ::OnBrowserReady.
  
• ISteamHTMLSurface::RemoveBrowser
  Вызовите эту функцию, когда закончите работу с HTML Surface. Это высвободит занятые им ресурсы.
  
• ISteamHTMLSurface::SetSize
  Вызовите эту функцию, чтобы задать область отображения HTML.
  
• ISteamHTMLSurface::LoadURL
  Открывает указанную страницу. Как только запрос начат, выполняется обратный вызов ISteamHTMLSurface::HTML_StartRequest_t.
  
• ISteamHTMLSurface::AllowStartRequest
  Этот вызов необходимо выполнить в ответ на обратный вызов ISteamHTMLSurface::HTML_StartRequest_t.

Настройка обратных вызовов

Для определения, что в браузере произошли те или иные события, могут быть настроены обратные вызовы (полный список см. в isteamhtmlsurface.h). Образец приложения Steamworks содержит пример использования нескольких обратных вызовов в htmlsurface.h/.cpp.
Для завершения простой реализации HTML Surface необходимо добавить обратный вызов ISteamHTMLSurface::HTML_NeedsPaint_t, который будет получать информацию для отображения на экране.

Реализация в образце приложения Steamworks

Приложение-образец с API Steamworks (SpaceWar), который предоставляется в комплекте с SDK, содержит простую реализацию API HTML Surface. После запуска образца откройте HTML-страницу. В игре откроется главная страница сообщества Steam.
Реализацию API HTML Surface можно найти в файлах htmlsurface.h и htmlsurface.cpp.
ПРИМЕЧАНИЕ: для приложения-образца пока не реализована возможность взаимодействия с веб-страницей.