บทนำ

ก่อนการผสานรวม 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 ในเครื่องยนต์ของคุณ

โปรดเพิ่มสคริปต์ต่อไปนี้ภายใน 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 window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Get user error: ', err);
}

หรือใช้วิธี Promise:

javascript

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Get user error: ', err));

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

ข้อมูล SysInfo

หลังจากที่เริ่มต้นสำเร็จและ callback กลับมา คุณสามารถรับข้อมูล SysInfo ได้ โปรดอย่าพลาดส่วนนี้ ซึ่งประกอบด้วยข้อมูลสำคัญเกี่ยวกับเครื่องยนต์เกมที่คุณใช้ คุณสามารถรับประเภทภาษาที่ผู้ใช้แพลตฟอร์มใช้งานอยู่ในขณะนั้น เพื่อให้เกมของคุณจับคู่ภาษาท้องถิ่นโดยอัตโนมัติ และอัปเดตเวลาเซิร์ฟเวอร์จริงภายในเกมของคุณ

javascript

SysInfo{
    "gameId": number；//รหัสเกม
    "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 เสร็จสิ้น สร้างเกมใหม่ใน พอร์ทัลนักพัฒนา และอัปโหลดไฟล์ทรัพยากรเกมที่เกี่ยวข้อง คุณจะสามารถพรีวิวเกมของคุณได้

บทนำ ​

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

ข้อมูล SysInfo ​

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

บทนำ

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

ข้อมูล SysInfo

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