Giới thiệu

Trước khi tích hợp JOGOS_SDK, vui lòng tuân thủ các yêu cầu của chúng tôi. Tài liệu này sẽ hướng dẫn bạn cách sử dụng JOGOS_SDK tối ưu nhất về mặt kỹ thuật, nội dung trò chơi, quảng cáo và yêu cầu tích hợp tài khoản.
Ngoài Unity và Cocos có thể sử dụng SDK chuyên dụng, các engine khác có thể tích hợp các tính năng thông qua phiên bản HTML5 vì hầu hết các engine hỗ trợ WebGL đều có cách tương tác với JavaScript khi chạy trên trình duyệt.

JOGOS_SDK bao gồm các module sau:

Module	Mô tả	HTML5 Native	Cocos	Unity
JOGOS_SDK.user	Tương tác với người dùng đăng nhập	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ
JOGOS_SDK.game	Hành vi trò chơi	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ
JOGOS_SDK.banner	Quảng cáo banner trong game	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ
JOGOS_SDK.ad	Quảng cáo video	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ
JOGOS_SDK.data	Lưu trữ đám mây	🟦 Sắp ra mắt	🟦 Sắp ra mắt	🟦 Sắp ra mắt
JOGOS_SDK.friend	Bạn bè và nhóm	🟨 Chưa hỗ trợ	🟨 Chưa hỗ trợ	🟨 Chưa hỗ trợ
JOGOS_SDK.purchase	Mua hàng trong ứng dụng	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ	🟩 Hỗ trợ đầy đủ
JOGOS_SDK.Active	Thành tích và bảng xếp hạng	🟦 Sắp ra mắt	🟦 Sắp ra mắt	🟦 Sắp ra mắt

Bắt đầu

Phần này hướng dẫn cách khởi chạy và vận hành JOGOS_SDK trong engine của bạn.

Vui lòng thêm script sau vào thẻ body trong file index.html của game để nhúng JOGOS_SDK:

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

Khởi tạo thủ công

JOGOS_SDK cần được khởi tạo trước khi sử dụng. Gọi phương thức JOGOS_SDK.init để hoàn tất khởi tạo:

await window.JOGOS_SDK.init();

Phương thức JOGOS_SDK.init là bất đồng bộ và bất kỳ phương thức nào khác đều không thể sử dụng trước khi nó thực thi thành công. Chúng tôi khuyến nghị nên thực hiện điều này trước khi bắt đầu game.

Nếu gọi các phương thức khác mà chưa gọi thành công JOGOS_SDK.init, sẽ ném ra ngoại lệ "460 Can only be called after the successful call of the JOGOS_SDK.init method"

Promise

Hầu hết các phương thức trong JOGOS_SDK đều bất đồng bộ, có thể gọi bằng cách sử dụng await:

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Lỗi lấy thông tin người dùng: ', err);
}

Hoặc có thể gọi bằng cách sử dụng Promise:

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Lỗi lấy thông tin người dùng: ', err));

Tải xuống cảnh mẫu tham khảo: HTML5_Demo.zip

Thông tin quan trọng

Sau khi callback khởi tạo thành công, có thể lấy thông tin SysInfo - đừng bỏ lỡ phần này vì nó chứa thông tin quan trọng về engine game bạn đang sử dụng. Bạn có thể lấy loại ngôn ngữ hiện tại của người dùng nền tảng, tự động khớp ngôn ngữ bản địa khi người chơi vào game, cập nhật thời gian máy chủ thực tế trong game, v.v...

SysInfo{
    "gameId": number; // ID game
    "hasGameGroup": bool; // Có bật trò chuyện nhóm không
    "deviceType": "desktop"; // Các giá trị có thể: "desktop", "tablet", "mobile"
    "language": string; // Loại ngôn ngữ
    "os": "Windows 10"; // Hệ điều hành và phiên bản
    "browser": "Chrome 10.0"; // Trình duyệt và phiên bản
    "serverTime": number; // Thời gian máy chủ hiện tại
}

Phát triển và kiểm thử

Trong quá trình phát triển, bạn sẽ thực thi JOGOS_SDK trong các môi trường khác nhau:

• localhost: Khi debug cục bộ, JOGOS_SDK sẽ cố gắng mô phỏng hành vi quảng cáo video/banner và các hành vi khác mà không tương tác với dịch vụ hoặc tải quảng cáo thực.
• Preview tool: Môi trường QA của chúng tôi cung cấp chức năng xem trước và kiểm tra thực tế. Sau khi tích hợp xong JOGOS_SDK, tạo game mới trên Cổng nhà phát triển và tải lên các file tài nguyên game liên quan, bạn có thể xem trước game của mình.