概览

Steam HTML Surface API 可用于在游戏或应用程序中直接显示和渲染基于 HTML 的页面。 此 API 基于 Chromium 嵌入式框架（Chromium Embedded Framework）构建并支持 HTML5 标记。

ISteamHTMLSurface 入门

ISteamHTMLSurface 接口在 isteamhtmlsurface.h 中实现，且能在 Steamworks SDK 中的 public/steam 文件夹找到。 可以通过 SteamHTMLSurface() 接口指针访问该接口。
下面列出了此 API 中最常用的方法。 请参见 API 索引，详细了解与网页的交互（滚动、点击链接）、 JavaScript 的使用、文件对话框等内容。

• ISteamHTMLSurface::Init
  请确保在使用此接口前先调用 Init。
  
• ISteamHTMLSurface::Shutdown
  请确保不再使用此接口时调用 Shutdown。
  
• ISteamHTMLSurface::CreateBrowser
  此函数将创建一个用于显示 HTML 页面的浏览器对象，并返回所创建的浏览器的 ISteamHTMLSurface::HTML_BrowserReady_t 句柄，该句柄随后可用于 ::OnBrowserReady 的 CallResult。
  
• ISteamHTMLSurface::RemoveBrowser
  使用完 HTML Surface 后调用此函数， 释放其使用的资源。
  
• ISteamHTMLSurface::SetSize
  调用此函数以设置 HTML 渲染区域大小。
  
• ISteamHTMLSurface::LoadURL
  导航至该 URL。 当请求开始时，会触发 ISteamHTMLSurface::HTML_StartRequest_t。
  
• ISteamHTMLSurface::AllowStartRequest
  在响应 ISteamHTMLSurface::HTML_StartRequest_t 回调时必须调用此函数。

回调设置

有一系列回调可供设置，用于确定特定浏览器事件何时发生（完整列表请参阅 isteamhtmlsurface.h）。 其中的 Steamworks 示例演示了如何在 htmlsurface.h/.cpp 中实现并使用部分这类回调。
要完成一个简单的 HTML Surface 实现，必须实现 ISteamHTMLSurface::HTML_NeedsPaint_t 回调，以获取要渲染的图像数据。

Steamworks 实现实例

与 SDK 一起发布的 Steamworks API 示例应用程序（SpaceWar）包含有 Steam HTML Surface API 的基本实现。 在启动此示例时，向下滚动，选择 HTML 页面。 随后就会在游戏中加载 Steam 社区主页。
可以在 htmlsurface.h 及 htmlsurface.cpp 文件中找到 Steam HTML Surface API 的集成。
注意：目前的示例中并未实现与网页的交互。