Огляд

API HTML-поверхні Steam дозволяє показувати HTML-сторінки безпосередньо в грі чи застосунку. Ця функція збудована на базі Chromium Embedded Framework і підтримує розмітку HTML5.

Початок роботи з ISteamHTMLSurface

Інтерфейс ISteamHTMLSurface впроваджено в isteamhtmlsurface.h і його можна знайти в теці public/steam у SDK Steamworks. Доступ до інтерфейсу можна отримати через вказівник інтерфейсу SteamHTMLSurface().
Нижче подається список найчастіше вживаних методів цього API. Звертайтеся до довідки API для докладного опису взаємодії з веб-сторінкою (прокручування, клацання на посилання), використання javascript, діалогових вікон вибору файлів тощо.

• ISteamHTMLSurface::Init
  Переконайтеся, що викликали Init перед використанням цього інтерфейсу.
  
• ISteamHTMLSurface::Shutdown
  Переконайтеся, що викликали Shutdown, коли інтерфейс більше не використовується.
  
• ISteamHTMLSurface::CreateBrowser
  Ця функція створить об’єкт браузера для показу HTML-сторінки й повертає обробник ISteamHTMLSurface::HTML_BrowserReady_t, який потім можна використовувати в CallResult for ::OnBrowserReady.
  
• ISteamHTMLSurface::RemoveBrowser
  Викликайте це, коли завершите з HTML-поверхнею. Це звільняє зайняті нею ресурси.
  
• ISteamHTMLSurface::SetSize
  Викликайте це для встановлення розміру відображення HTML.
  
• ISteamHTMLSurface::LoadURL
  Навігація до URL. Повертається ISteamHTMLSurface::HTML_StartRequest_t, коли запит розпочато.
  
• ISteamHTMLSurface::AllowStartRequest
  Це необхідно викликати у відповідь на зворотний виклик ISteamHTMLSurface::HTML_StartRequest_t.

Встановлення зворотних викликів

Для визначення, що в браузері виникли ті чи інші події, можна встановити зворотні виклики (див. isteamhtmlsurface.h для повного списку). Приклад застосунку Steamworks демонструє впровадження та використання одного з цих зворотних викликів у htmlsurface.h/.cpp.
Для завершення простого впровадження HTML-поверхні слід створити зворотний виклик ISteamHTMLSurface::HTML_NeedsPaint_t для отримання інформації до відображення.

Впровадження в прикладі Steamworks

Приклад, що додається до SDK, містить базове впровадження API HTML-поверхні Steam. Після запуску прикладу прокрутіть униз та оберіть HTML-сторінку. Домашня сторінка спільноти Steam відкриється в грі.
Інтеграцію API HTML-поверхні Steam ви можете знайти у файлах htmlsurface.h і htmlsurface.cpp.
ПРИМІТКА: інтерактивність веб-сторінки ще не реалізована в прикладі.