Skip to content

บทนำ

ก่อนที่จะรวม JOGOS_SDK โปรดปฏิบัติตามข้อกำหนด ของเราเสมอ ซึ่งจะช่วยให้คุณใช้ JOGOS_SDK ได้อย่างมีประสิทธิภาพสูงสุด และให้คำแนะนำเกี่ยวกับข้อกำหนดทางเทคนิค เนื้อหาเกม โฆษณา และการรวมบัญชี

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

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

โมดูลคำอธิบายHTML5 ดั้งเดิมCocosUnity
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 ในเอ็นจิ้น

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

html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
การเริ่มต้นด้วยตนเอง

JOGOS_SDK ต้องถูกเริ่มต้นก่อนจึงจะสามารถใช้งานได้ เริ่มต้นโดยเรียกใช้เมธอด JOGOS_SDK.init:

javascript
await window.JOGOS_SDK.init();

เมธอด JOGOS_SDK.init เป็นแบบอะซิงโครนัส และเมธอดอื่นๆ จะไม่สามารถใช้งานได้จนกว่าเมธอด JOGOS_SDK.init จะทำงานสำเร็จ เราขอแนะนำอย่างยิ่งให้คุณดำเนินการนี้ก่อนเริ่มเกม

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

Promise

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

javascript
try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('ข้อผิดพลาดในการรับผู้ใช้: ', err);
}

หรือสามารถเรียกใช้ด้วย Promise:

javascript
window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('ข้อผิดพลาดในการรับผู้ใช้: ', err));

สามารถดาวน์โหลดตัวอย่างฉากเพื่ออ้างอิงได้ที่: HTML5_Demo.zip

ข้อมูลสำคัญ

เมื่อการเริ่มต้นสำเร็จและได้รับ 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 เข้ากับเกมแล้ว คุณสามารถสร้างเกมใหม่และอัปโหลดไฟล์ทรัพยากรเกมที่เกี่ยวข้องบน พอร์ทัลนักพัฒนา จากนั้นจึงสามารถแสดงตัวอย่างเกมของคุณได้