บทนำ

ก่อนการผสานรวม JOGOS_SDK กรุณาปฏิบัติตามข้อกำหนดของเรา ซึ่งจะช่วยให้คุณใช้งาน JOGOS_SDK ได้อย่างมีประสิทธิภาพสูงสุด และให้คำแนะนำเกี่ยวกับข้อกำหนดด้านเทคนิค เนื้อหาเกม โฆษณา และการผสานรวมบัญชี
นอกจาก Unity และ Cocos ที่สามารถใช้ SDK เฉพาะได้แล้ว เครื่องยนต์อื่น ๆ ของคุณสามารถผสานรวมฟังก์ชันเหล่านี้ผ่านเวอร์ชัน HTML5 ได้ เนื่องจากเครื่องยนต์เกมส่วนใหญ่ที่รองรับ WebGL มักมีวิธีโต้ตอบกับ JavaScript เมื่อทำงานในเบราว์เซอร์

JOGOS_SDK ประกอบด้วยโมดูลต่อไปนี้:

โมดูล	คำอธิบาย	การสนับสนุน SDK	คำแนะนำการเชื่อมต่อ
JOGOS_SDK.init	เริ่มต้น SDK	🟩 รองรับเต็มรูปแบบ	☑️จำเป็นต้องเชื่อมต่อ อธิบายเพิ่มเติมด้านล่าง
JOGOS_SDK.game	พฤติกรรมของเกม	🟩 รองรับเต็มรูปแบบ	☑️ จำเป็น แจ้งให้เราทราบเมื่อเกมโหลด เริ่ม หรือหยุดชั่วคราว
JOGOS_SDK.user	โต้ตอบกับผู้ใช้ที่เข้าสู่ระบบ	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากใช้ระบบผู้ใช้จึงต้องการ
JOGOS_SDK.banner	แบนเนอร์โฆษณาในเกม	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากเกมของคุณมีแบนเนอร์โฆษณา
JOGOS_SDK.ad	วิดีโอรางวัลและโฆษณาแบบเต็มหน้าจอ	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากเกมของคุณมีโฆษณาวิดีโอ
JOGOS_SDK.data	การจัดเก็บบนคลาวด์	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากต้องการใช้การจัดเก็บบนคลาวด์ของ Jogos
JOGOS_SDK.friend	เพื่อนและกลุ่ม	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็นหากเกมต้องระบบปฏิสัมพันธ์ผู้เล่น
JOGOS_SDK.payment	การซื้อภายในเกมและการซื้อแบบครั้งเดียว	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากเกมของคุณมีการซื้อภายในแอปหรือการซื้อแบบครั้งเดียว
JOGOS_SDK.active	ความสำเร็จและกระดานผู้นำ	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากต้องการใช้ระบบความสำเร็จและกระดานผู้นำของ Jogos
JOGOS_SDK.cdkey	ฟังก์ชันรหัสแลกเปลี่ยน	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็น หากต้องการให้ Jogos จัดการรหัสแลกเปลี่ยน
JOGOS_SDK.gameItem	ไอเท็มและร้านค้า	🟩 รองรับเต็มรูปแบบ	🔳ไม่จำเป็นสำหรับเกมเดี่ยวที่ Jogos จัดการรายการไอเท็มและการซื้อ
JOGOS_SDK.room	ห้องต่อสู้	🟨 ยังไม่รองรับ	🔳ไม่จำเป็นหากสนับสนุน LAN มัลติเพลย์และแพลตฟอร์มให้ห้องออนไลน์

เริ่มต้นใช้งาน

ส่วนนี้จะอธิบายวิธีเริ่มต้นและรัน JOGOS_SDK ในเครื่องยนต์ของคุณ

โปรดเพิ่มสคริปต์ต่อไปนี้ภายใน body ของไฟล์ index.html เพื่อนำเข้า JOGOS_SDK:

html

<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>

การเริ่มต้นเอง

JOGOS_SDK จำเป็นต้องถูกเริ่มต้นก่อนใช้งาน โดยเรียกใช้เมธอด JOGOS_SDK.init:

javascript

let systemInfo = await window.JOGOS_SDK.init();

เมธอด JOGOS_SDK.init เป็นแบบ asynchronous และเมธอดอื่น ๆ จะไม่สามารถใช้งานได้จนกว่า JOGOS_SDK.init จะทำงานสำเร็จ เราแนะนำให้ดำเนินการนี้ก่อนเริ่มเกม

หากเรียกใช้เมธอดอื่นก่อนที่ JOGOS_SDK.init จะทำงานสำเร็จ จะเกิดข้อผิดพลาด "460 Can only be called after the successful call of the JOGOS_SDK.init method"

Promise

เมธอดส่วนใหญ่ใน JOGOS_SDK เป็นแบบ asynchronous และสามารถเรียกใช้ด้วย await:

javascript

try {
const user = await JogosSDK.getUser();
console.log(user);
} catch (err) {
console.log('ล้มเหลวในการดึงข้อมูลผู้ใช้：', err);
}
//วิธีเรียก Promise ที่เทียบเท่า：
JogosSDK
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('ล้มเหลวในการดึงข้อมูลผู้ใช้：', err));

ดาวน์โหลดตัวอย่างซีนได้ที่: HTML5_Demo.zip

ข้อมูล SysInfo

หลังจากที่การเรียกกลับเริ่มต้นสำเร็จแล้ว อย่าพลาดข้อมูล SysInfo ที่คุณสามารถรับได้ เพราะมีข้อมูลสำคัญเกี่ยวกับเกมเอ็นจิ้นที่คุณกำลังใช้อยู่:

หากคุณต้องการปรับปรุงอินเทอร์เฟซควบคุมโดยอัตโนมัติตามประเภทอุปกรณ์ของผู้เล่น ให้ใช้ฟิลด์ deviceType
หากคุณต้องการซิงค์เวลาของเซิร์ฟเวอร์แบบไดนามิกเพื่อให้แน่ใจว่ากิจกรรมมีความยุติธรรม ให้ใช้ฟิลด์ serverTime
หากคุณต้องการเปลี่ยนข้อความโลคาไลซ์อัตโนมัติตามการตั้งค่าภาษาของผู้เล่น ให้ใช้ฟิลด์ language
หากคุณต้องการควบคุมความถี่ในการแสดงโฆษณาแบนเนอร์อย่างยืดหยุ่น ให้ใช้ฟิลด์ bannerIntervalTime
หากคุณต้องการใช้งานฟังก์ชันเชิญเพื่อนจากแพลตฟอร์มในฉากเกมหลายผู้เล่น ให้ใช้ฟิลด์ invateArgs
หากคุณต้องการปรับปรุงประสิทธิภาพความเข้ากันได้สำหรับระบบปฏิบัติการเวอร์ชันต่างๆ ให้ใช้ฟิลด์ os

javascript

SysInfo{
    "gameId": number；//รหัสเกม
    "hasGameGroup":bool；//เปิดใช้งานแชทกลุ่มหรือไม่
    "deviceType": "desktop" ；// ค่าที่เป็นไปได้: "desktop", "tablet", "mobile"
    "language": string；//ประเภทภาษา
    "os":"Windows 10"；//ระบบปฏิบัติการและเวอร์ชัน
    "browser":"Chrome 10.0"；//เบราว์เซอร์และเวอร์ชัน
    "serverTime": number；//เวลาเซิร์ฟเวอร์ปัจจุบัน
    "bannerIntervalTime": number;//เวลาแสดงช่วงเวลาของโฆษณาแบนเนอร์เกม
    "MidgameIntervalTime": number;//เวลาแสดงช่วงเวลาของโฆษณา interstitial ระหว่างเกม
    "gamePrice": number;//ราคาซื้อเกมครั้งเดียว
    "invateArgs": number;// พารามิเตอร์เชิญ
}

การพัฒนาและการทดสอบ

ในระหว่างการพัฒนา คุณจะดำเนินการ JOGOS_SDK ในสภาพแวดล้อมต่าง ๆ:

localhost ขณะดีบักในเครื่อง JOGOS_SDK จะพยายามจำลองพฤติกรรมของ วิดีโอโฆษณา/แบนเนอร์ และอื่น ๆ โดยไม่มีการโต้ตอบกับเซิร์ฟเวอร์หรือโหลดโฆษณาจริง
Preview tool เรามีฟังก์ชันการพรีวิวและตรวจสอบจริงในสภาพแวดล้อม QA หลังจากที่คุณผสานรวม JOGOS_SDK เสร็จสิ้น สร้างเกมใหม่ใน พอร์ทัลนักพัฒนา และอัปโหลดไฟล์ทรัพยากรเกมที่เกี่ยวข้อง คุณจะสามารถพรีวิวเกมของคุณได้

บทนำ ​

เริ่มต้นใช้งาน ​

ข้อมูล SysInfo ​

การพัฒนาและการทดสอบ ​

บทนำ

เริ่มต้นใช้งาน

ข้อมูล SysInfo

การพัฒนาและการทดสอบ