บทนำ
ก่อนที่จะรวม 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
ในเอ็นจิ้น
โปรดเพิ่มสคริปต์ต่อไปนี้ใน body
ของไฟล์ index.html
ของเกมเพื่อนำเข้า JOGOS_SDK
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
เมธอดส่วนใหญ่ใน JOGOS_SDK
เป็นแบบอะซิงโครนัส และสามารถเรียกใช้ด้วย await
:
try {
const user = await window.JOGOS_SDK.user.getUser();
console.log(user);
} catch (err) {
console.log('ข้อผิดพลาดในการรับผู้ใช้: ', err);
}
หรือสามารถเรียกใช้ด้วย Promise
:
window.JOGOS_SDK.user
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('ข้อผิดพลาดในการรับผู้ใช้: ', err));
สามารถดาวน์โหลดตัวอย่างฉากเพื่ออ้างอิงได้ที่: HTML5_Demo.zip
ข้อมูลสำคัญ
เมื่อการเริ่มต้นสำเร็จและได้รับ callback แล้ว คุณสามารถรับข้อมูล SysInfo
ได้ โปรดอย่าพลาดส่วนนี้ เพราะมีข้อมูลสำคัญเกี่ยวกับเอ็นจิ้นเกมที่คุณใช้ คุณสามารถรับประเภทภาษาที่ผู้ใช้แพลตฟอร์มใช้อยู่ ปล่อยให้ผู้เล่นเข้าสู่เกมของคุณโดยจับคู่ภาษาท้องถิ่นโดยอัตโนมัติ อัปเดตเวลาจริงของเซิร์ฟเวอร์ในเกมของคุณ เป็นต้น
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
เข้ากับเกมแล้ว คุณสามารถสร้างเกมใหม่และอัปโหลดไฟล์ทรัพยากรเกมที่เกี่ยวข้องบน พอร์ทัลนักพัฒนา จากนั้นจึงสามารถแสดงตัวอย่างเกมของคุณได้