Chức năng chuyển đổi và dữ liệu người chơi

Bạn có thể lưu trạng thái của trò chơi (các cấp độ đã hoàn thành, kinh nghiệm, mua sắm trong trò chơi v.v.) trên server của Yandex hoặc chuyển chúng sang server của bạn. Bạn cũng có thể tùy chỉnh trò chơi bằng cách sử dụng một số dữ liệu từ profile của người dùng trên Yandex, ví dụ như tên.

Thông tin về người chơi

Để bắt đầu làm việc với dữ liệu của người chơi, hãy sử dụng điều kiện Using player info. Điều kiện đặc biệt này yêu cầu sự cho phép từ người chơi và lấy dữ liệu về người chơi từ Yandex Games để làm việc tiếp theo.

Bằng việc sử dụng điều kiện này, bạn có thể truy cập vào kiểm tra quá trình xác thực của người dùng, lấy tên của họ v.v. Hãy nhớ rằng tất cả logic sử dụng thông tin này phải ở trong Using player info.

Cảnh báo

Hãy chắc chắn rằng điều kiện này không được gọi nhiều lần liên tiếp. Được gợi ý sử dụng nó trong các hàm hoặc trình chuyển tiếp loại "Khi khởi động bản thảo".

Trong điều kiện đặc biệt Using player info, bạn có thể sử dụng:

  • Điều kiện Player is authorized: kiểm tra xem người chơi có được xác thực trên Yandex hay không.
  • Điều kiện Player personal info access granted: kiểm tra xem có nhận được dữ liệu riêng của người chơi hay không.
  • Biểu thức Player signature: string, chứa dữ liệu người dùng từ profile của Yandex và chữ kí. Gồm hai dòng mã hóa trong định dạng Base64.
  • Biểu thức Player avatar: string, liên kết đến avatar của người chơi.
  • Biểu thức Player name: string, tên của người chơi.
  • Biểu thức Player unique id: string, mã số riêng biệt của người chơi.

Dữ liệu trong trò chơi

Để làm việc với dữ liệu trong trò chơi của người dùng, hãy sử dụng các hành động:

  • Get player data — yêu cầu dữ liệu của người chơi trong trò chơi và ghi chú chúng vào một đối tượng JSON.
  • Set player data — gửi dữ liệu của người chơi trong trò chơi sang Yandex Games từ một đối tượng JSON.
  • Get player stats — yêu cầu dữ liệu số liệu của người chơi và ghi chú chúng vào một đối tượng JSON.
  • Set player stats — gửi dữ liệu số liệu của người chơi sang Yandex Games từ một đối tượng JSON.
  • Increment player stats — tăng dữ liệu số liệu của người chơi lên một giá trị được chỉ định.

Cảnh báo

Tất cả các hành động này là async và việc chúng hoạt động chiếm một khoảng thời gian. Đừng quên sử dụng hành động Wait for previous actions để tránh lỗi.


Kho lưu trữ