Chế độ đa người chơi không đồng bộ

Với mô-đun ysdk.multiplayer, bạn có thể tạo chế độ cạnh tranh giống như nhiều người chơi trực tuyến. Khi đó, bạn không cần phải:

• viết và duy trì giải pháp máy chủ của riêng mình;
• có đủ khối lượng người chơi cần thiết để tìm kiếm đối thủ nhanh chóng.

Các thể loại game mà bạn có thể thực hiện cốt lõi thông qua SDK:

• Trò chơi giải đố: các phiên chơi không đồng bộ có thể được phát trên bảng trò chơi lân cận, có thể thêm sự cạnh tranh về thời gian hoặc điểm số. Ví dụ về các trò chơi phù hợp: Solitaire Online! (của KosmosGames), Match Arena - Ba trong Một! (của PecPoc Piggy).
• Chạy nhảy và đua xe: các phiên của đối thủ có thể được hiển thị dưới dạng “bóng mờ”, di chuyển qua cấp độ đồng thời với người chơi (cơ chế ghost driver). Ví dụ về các trò chơi phù hợp: Xe điên 2 (của JL studio) ở chế độ “Đua tốc độ”, Mô tô điên (của haoda games).
• Chiến thuật và autobattle: bạn có thể thực hiện các trận đấu chống lại chiến thuật của các người chơi khác. Ví dụ về các trò chơi phù hợp: Ludus (của Positron Dynamics), Like a King (của Vladimir Saponenko), TOYS: Crash Arena (của Mad Pixel).

Khái niệm

1. Người dùng A chơi, SDK ghi lại các sự kiện chính (nhấn phím, thay đổi trạng thái) và ghi nhận thời gian của chúng.
2. Các sự kiện này được lưu trữ trên máy chủ dưới dạng timeline (danh sách giao dịch).
3. Khi người dùng B khởi động trò chơi, đối thủ trong phiên của họ sẽ được tải từ các timeline đã được lưu trữ.
4. SDK phát lại các hành động của đối thủ theo thời gian thực, tạo cảm giác như đang chơi cùng lúc.

Khởi tạo và tải các phiên

Để bắt đầu với chế độ multiplayer không đồng bộ, hãy gọi phương thức ysdk.multiplayer.sessions.init(). Trong phương thức này, việc khởi tạo ban đầu và tải các phiên chơi của đối thủ được thực hiện.

Phương thức trả về mảng các phiên đã tải.

Tham số count xác định số lượng phiên cần tải. Số phiên tối đa trong phản hồi là 10.

Các tham số meta1, meta2, meta3 được sử dụng để lựa chọn. Chúng có dạng các đối tượng { min: %number%, max: %number% } và được thiết lập khi lưu phiên. Ví dụ, nếu meta1 chứa điểm số trong trò chơi và meta2 chứa cấp độ của người chơi, bạn có thể tải các phiên đã lưu gần với người dùng hiện tại theo các tham số này.

ysdk.multiplayer.sessions.init({
  count: 2, // Số lượng phiên đối thủ để tải (tối đa 10).
  isEventBased: true, // Cờ để khởi tạo hoạt động thông qua sự kiện.
  maxOpponentTurnTime: 200, // Giới hạn thời gian lượt đi của đối thủ (ms).
  meta: {
    meta1: {
      min: 0,
      max: 6000,
    },
    meta2: {
      min: 2,
      max: 10,
    },
  },
}).then(opponents => console.log(opponents));

const work = async () => {
  const opponents = await ysdk.multiplayer.sessions.init({
    count: 2, // Số lượng phiên đối thủ để tải (tối đa 10).
    isEventBased: true, // Cờ để khởi tạo hoạt động thông qua sự kiện.
    maxOpponentTurnTime: 200, // Giới hạn thời gian lượt đi của đối thủ (ms).
    meta: {
      meta1: {
        min: 0,
        max: 6000,
      },
      meta2: {
        min: 2,
        max: 10,
      },
    },
  });

  console.log(opponents);
}

work();

Định dạng câu trả lời

[
  {
    id: string;
    meta: {
      meta1: number;
      meta2: number;
      meta3: number;
    };
    player: {
      avatar: string;
      name: string;
    };
    timeline: [
      {
        id: string;
        payload: object | string | undefined;
        time: number;
      },
      ...
    ];
  },
  ...
]

Ghi lại phiên chơi game

Sử dụng SDK để ghi lại các phiên chơi game của người dùng (chuỗi sự kiện kèm theo dấu thời gian). Các sự kiện có thể là di chuyển các quân cờ trên bàn cờ trong trò chơi giải đố hoặc nhấn các phím của bàn phím hoặc chuột trong các trò chơi chạy không ngừng.

Trong các trò chơi mà đầu vào của người dùng là liên tục, ví dụ như trong các trò chơi chạy không ngừng, các sự kiện có thể được tạo ra một cách nhân tạo trong một khoảng thời gian quy định, ghi lại trạng thái của nhân vật — tọa độ, mức năng lượng, v.v. Điều này cũng có thể là các sự kiện ngẫu nhiên trong trò chơi — phần thưởng, động đất.

Các sự kiện diễn ra trong trò chơi được lưu trữ dưới dạng giao dịch. Mỗi giao dịch có:

• id — định danh duy nhất của sự kiện;
• payload — dữ liệu sự kiện: thông tin phản ánh bản chất, lý do thay đổi trong thế giới trò chơi (ví dụ, tọa độ mới của nhân vật hoặc nhấn nút chuột);
• time — thời gian kể từ khi bắt đầu trò chơi với sự điều chỉnh cho việc tạm dừng.

Trong suốt trò chơi, lưu trữ payload bằng phương thức commit(). Điều này sẽ hình thành danh sách các giao dịch — dòng thời gian của phiên chơi game (timeline).

Cuối trò chơi, lưu trữ phiên chơi trên máy chủ bằng phương thức push(). Sau khi lưu trữ, phiên chơi có thể được tải và phát lại trong trò chơi tiếp theo.

ysdk.multiplayer.sessions.commit()

Phương thức commit() xác định các giao dịch của phiên chơi hiện tại. Dữ liệu sự kiện (payload) được truyền vào phương thức này.

Ví dụ sử dụng

// Giao dịch đầu tiên.
ysdk.multiplayer.sessions.commit({ x: 1, y: 2, z: 3, health: 67 });

// .......

// Giao dịch tiếp theo.
ysdk.multiplayer.sessions.commit({ x: 4, y: -2, z: 19, health: 15 });

// .......

ysdk.multiplayer.sessions.push()

Phương thức push() được sử dụng để lưu trữ timeline lên máy chủ từ xa. Phương thức này được gọi khi trò chơi kết thúc.

Các giá trị meta1, meta2, meta3 được thiết lập khi lưu phiên làm việc. Ít nhất một trong các tham số meta phải được xác định rõ.

Ví dụ sử dụng

ysdk.multiplayer.sessions.push({ meta1: 12, meta2: -2 });

Làm việc với phiên

Để chọn cách làm việc với các phiên đã tải của đối thủ, trong phương thức init(), truyền giá trị cần thiết của cờ isEventBased:

• true — làm việc thông qua sự kiện;
• false — tự xử lý.

ysdk.multiplayer.sessions.init({
  count: 2, // Số lượng phiên đối thủ để tải (tối đa 10).
  isEventBased: true, // Cờ để khởi tạo hoạt động thông qua sự kiện.
  maxOpponentTurnTime: 200, // Giới hạn thời gian lượt đi của đối thủ (ms).
  meta: {
    meta1: {
      min: 0,
      max: 6000,
    },
    meta2: {
      min: 2,
      max: 10,
    },
  },
});

// Ở đây đến một mảng giao dịch để thực hiện tại thời điểm hiện tại:
// giao dịch hiện tại, cùng với các giao dịch bị trì hoãn do trò chơi có thể bị đóng băng.
ysdk.on('multiplayer-sessions-transaction', ({ opponentId, transactions }) = > {
  console.log(opponentId, transactions);
  // Áp dụng dữ liệu transaction.payload trên sân chơi.
});

ysdk.on('multiplayer-sessions-finish', (opponentId) => console.log(opponentId));

// Bắt đầu chế độ nhiều người chơi.
ysdk.features.GameplayAPI.start();

// Tạm dừng chế độ nhiều người chơi.
ysdk.features.GameplayAPI.stop();

const start = (opponent) => {
  console.log('player', opponent.player);
  console.log('timeline', opponent.timeline);

  // Triển khai cơ chế sử dụng dữ liệu dòng thời gian và người chơi.
}

const work = async () => {
  const opponents = await ysdk.multiplayer.sessions.init({
    count: 2, // Số lượng phiên đối thủ để tải (tối đa 10).
    isEventBased: false, // Cờ để khởi tạo hoạt động thông qua sự kiện.
    maxOpponentTurnTime: 200, // Giới hạn thời gian lượt đi của đối thủ (ms).
    meta: {
      meta1: {
        min: 0,
        max: 6000,
      },
      meta2: {
        min: 2,
        max: 10,
      },
    },
  });

  console.log('opponents', opponents);

  for (let i = 0; i < opponents.length; i++) {
    start(opponents[i]);
  }
}

work();

Nếu bạn đang gặp phải vấn đề hoặc có câu hỏi liên quan đến việc sử dụng Yandex Games SDK, vui lòng liên hệ với bộ phận hỗ trợ: