Genel Bakış

Steam HTML Surface API'yı HTML tabanlı sayfaların oyunlarda veya uygulamalarda doğrudan görüntülenebilmesine olanak tanır. Chromium Embedded Framework temel alınarak geliştirilmiştir ve HTML5 biçimlendirmesini desteklemektedir.

ISteamHTMLSurface ile Başlarken

ISteamHTMLSurface arayüzü isteamhtmlsurface.h'ye entegre edilir ve Steamworks SDK'sinde yer alan public/steam klasöründe bulunabilir. Arayüze, arayüz göstergesi olan SteamHTMLSurface() aracılığıyla erişilebilir.
Aşağıda bu API'da en yaygın kullanılan yöntemlerin bir listesi yer almaktadır. Javascript, dosya diyalogları, vb. şeyleri kullanarak internet sayfasıyla etkileşime geçmekle (kaydırma, bağlantılara tıklama) ilgili daha fazla detaylı bilgi için API referansına bakın.

• ISteamHTMLSurface::Init
  Bu arayüzü kullanmadan önce Init'in çağrılmış olduğundan emin olun.
  
• ISteamHTMLSurface::Shutdown
  Bu arayüz kullanılmadığı zamanlar Shutdown'ın çağrılmış olduğundan emin olun.
  
• ISteamHTMLSurface::CreateBrowser
  Bu işlev, bir HTML sayfasının gösterilmesi için bir tarayıcı objesi oluşturur ve ::OnBrowserReady için CallResult'ta kullanılabilecek ISteamHTMLSurface::HTML_BrowserReady_t değerini oluşturulan tarayıcıya döndürür.
  
• ISteamHTMLSurface::RemoveBrowser
  HTML surface ile işiniz bittiğinde bunu çağırın. Bu, bunun tarafından kullanılan kaynakları boşa çıkartır.
  
• ISteamHTMLSurface::SetSize
  HTML oluşturma alanının boyutunu belirlemek için bunu çağırın.
  
• ISteamHTMLSurface::LoadURL
  URL'e git. İstek başladığı zaman ISteamHTMLSurface::HTML_StartRequest_t olarak sonuçlanır.
  
• ISteamHTMLSurface::AllowStartRequest
  ISteamHTMLSurface::HTML_StartRequest_t geri çağrısına yanıt olarak bunu çağırmalısınız.

Geri Çağrı Kurulumu

Bir tarayıcı etkinliği meydana geldiğinde (tam liste için isteamhtmlsurface.h'e bakın) bunları belirleyecek bir dizi geri çağrı vardır. Steamworks örneğindeki htmlsurface.h/.cpp'de yer alan bazı geri çağrıların kullanımı ve entegrasyonu vardır.
Basit bir HTML Surface entegrasyonunu tamamlamak için; oluşturmada kullanılacak görsel verinin alınabilmesi için ISteamHTMLSurface::HTML_NeedsPaint_t'ye yapılacak bir geri çağrı entegre edilmelidir.

Steamworks Örnek Entegrasyonu

SDK ile birlikte gelen Steamworks API Example Application (SpaceWar), Steam HTML Surface API'nın temel entegrasyonuyla ilgili bir örnek içerir. Örneği başlattıktan sonra aşağıya kaydırın ve HTML sayfasını seçin. Ardından Steam Topluluğu ana sayfası oyun içinde yüklenecektir.
Steam HTML Surface API'nın entegrasyonunu htmlsurface.h vehtmlsurface.cpp dosyalarında bulabilirsiniz.
NOT: İnternet sayfasıyla etkileşim bu örnekte entegre edilmemiş vaziyettedir.