簡介
在集成JOGOS_SDK
之前,請務必遵循我們的要求。它將幫助您以最佳方式使用JOGOS_SDK
,並在技術、遊戲內容、廣告和帳戶集成要求方面為您提供指導。 除了 Unity 和 Cocos 可以使用專屬 SDK 外,您的其他引擎可以通過HTML5
版本集成這些功能,因為大多數支持WebGL
的遊戲引擎在瀏覽器中運行時都有與JavaScript
交互的方式。
JOGOS_SDK
包含以下模塊:
模塊 | 說明 | 原生 HTML5 | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | 與登錄用戶進行交互 | 🟩 完全支持 | 🟩 完全支持 | 🟩 完全支持 |
JOGOS_SDK.game | 遊戲行為 | 🟩 完全支持 | 🟩 完全支持 | 🟩 完全支持 |
JOGOS_SDK.banner | 遊戲內橫幅廣告 | 🟩 完全支持 | 🟩 完全支持 | 🟩 完全支持 |
JOGOS_SDK.ad | 視頻廣告 | 🟩 完全支持 | 🟩 完全支持 | 🟩 完全支持 |
JOGOS_SDK.data | 雲存檔 | 🟦 即將推出 | 🟦 即將推出 | 🟦 即將推出 |
JOGOS_SDK.friend | 好友與群組 | 🟨 暫不支持 | 🟨 暫不支持 | 🟨 暫不支持 |
JOGOS_SDK.purchase | 內購與買斷制 | 🟩 完全支持 | 🟩 完全支持 | 🟩 完全支持 |
JOGOS_SDK.Active | 成就與排行榜 | 🟦 即將推出 | 🟦 即將推出 | 🟦 即將推出 |
開始
本節介紹如何在引擎中啟動並運行JOGOS_SDK
。
請在遊戲的index.html
文件中的body
內,添加以下腳本來引入JOGOS_SDK
:
html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Pormise
JOGOS_SDK
中的絕大多數方法都是異步的,可以使用await
的方式調用:
javascript
try {
const user = await window.JOGOS_SDK.user.getUser();
console.log(user);
} catch (err) {
console.log('獲取用戶信息錯誤: ', err);
}
也可以使用Pormise
的方式調用:
javascript
window.JOGOS_SDK.user
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('獲取用戶信息錯誤: ', err));
可下載示例場景參考 :HTML5_Demo.zip
重要信息
當初始化成功回調後,可獲取SysInfo
信息請不要錯過此部分,其中包含有關您所使用的遊戲引擎的重要信息;您可以獲取到平台用戶當前使用的語言類型;讓玩家進入你的遊戲時自動匹配本地化語言。更新你遊戲內真實的服務器時間等。。
javascript
SysInfo{
"gameId": number;//遊戲 Id
"hasGameGroup":bool;//是否開啟群聊
"deviceType": "desktop" ;// 可能的值: "desktop", "tablet", "mobile"
"language": string;//語言類型
"os":"Windows 10";//系統與版本
"browser":"Chrome 10.0";//瀏覽器與版本
"serverTime": number;//當前服務器時間
}
開發與測試
在開發過程中,您將在不同的環境中執行JOGOS_SDK
:
localhost
在本地調試開發時,JOGOS_SDK
會嘗試模擬視頻廣告/橫幅
及其他等行為,並不會與服務交互或加載真實的廣告。Preview tool
在我們的QA
環境中提供了真實的預覽及檢測功能。遊戲集成完JOGOS_SDK
後,在開發者門戶 上創建新遊戲並上傳了相關的遊戲資源文件後,就可以預覽您的遊戲了。