Введение

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.
Примечание: интерактивность в приложении-образце пока не реализована.