クロスプレイヤーデータの操作

• Cloud Save で一度に複数のプレイヤーのプレイヤーデータを更新します。
• 一度に複数のプレイヤーの Economy 残高を更新します。

プレイヤー ID の取得

Leaderboards の使用

JavaScript

const { LeaderboardsApi } = require("@unity-services/leaderboards-1.1");module.exports = async ({ params, context, logger }) => {  const leaderboardsApi = new LeaderboardsApi(context);  let result;  try {    result = await leaderboardsApi.getLeaderboardScores(context.projectId, params.leaderboardId, 0, 5);    return result.data.results;  } catch (err) {    logger.error("Failed to retrieve players from the leaderboard", {"error.message": err.message}, {"leaderboardId" : params.leaderboardId});    throw err;  }};// Uncomment the code below to enable the inline parameter definition// - Requires Cloud Code JS dev environment setup with NodeJS (https://docs.unity3d.com/Packages/com.unity.services.cloudcode@latest/index.html?subfolder=/manual/Authoring/javascript_project.html)//// module.exports.params = {//   leaderboardId: { type: "String", required: true },// };

{    "output": [        {            "playerId": "wYI5NW5gEVvR3PBmYXEzFS1JvSz3",            "playerName": "IncredibleGleamingPelican#3",            "rank": 0,            "score": 44.0        },        {            "playerId": "ryuAA3ZX23aRHN5ZJClC1Z5BrpVb",            "playerName": "EffectiveBindingBlackberry#9",            "rank": 1,            "score": 1.0        }    ]}

Lobby の使用

JavaScript

const { LobbyApi } = require("@unity-services/lobby-1.2");module.exports = async ({ params, context, logger }) => {  const lobbyApi = new LobbyApi(context);  try {    // Get and return the lobby.    const getResponse = await lobbyApi.getLobby(params.lobbyId, "cloud-code");    return getResponse.data.players;  } catch (err) {    logger.error("Failed to retrieve players from the Lobby", {"error.message": err.message}, {"lobbyId" : params.lobbyId});    throw err;  }};// Uncomment the code below to enable the inline parameter definition// - Requires Cloud Code JS dev environment setup with NodeJS (https://docs.unity3d.com/Packages/com.unity.services.cloudcode@latest/index.html?subfolder=/manual/Authoring/javascript_project.html)//// module.exports.params = {//   lobbyId: { type: "String", required: true },// };

{    "output": [        {            "allocationId": null,            "connectionInfo": null,            "data": null,            "id": "Z96pNb4wfgdaMLqMQfWpwXEclaRR",            "joined": "2023-09-08T11:02:18.13Z",            "lastUpdated": "2023-09-08T11:02:18.13Z"        }    ]}

Friends の使用

任意 - 友達リクエストの送信

JavaScript

const { RelationshipsApi } = require("@unity-services/friends-1.0");module.exports = async ({ params, context, logger }) => {  const relationshipsApi = new RelationshipsApi({ accessToken: context.accessToken });  try {    const payload = {      type: "FRIEND_REQUEST",      members: [{ id: params.playerId }]    };    const createRes = await relationshipsApi.createRelationship(true, true, payload);    logger.info(`New relationship initiated: ${JSON.stringify(createRes.data)}`)  } catch (err) {    // The call will fail if the friend request has already been sent    logger.error("Error while sending a friend request", { "error.message": err.message });  }  try {    const list = await relationshipsApi.getRelationships(10, 0, true, true, ["FRIEND_REQUEST", "FRIEND"]);    logger.info(`Retrieved relationships: ${JSON.stringify(list.data)}`)  } catch (err) {    logger.error("Error while retrieving relationships", { "error.message": err.message });  }}// Uncomment the code below to enable the inline parameter definition// - Requires Cloud Code JS dev environment setup with NodeJS (https://docs.unity3d.com/Packages/com.unity.services.cloudcode@latest/index.html?subfolder=/manual/Authoring/javascript_project.html)//// module.exports.params = {//   playerId: { type: "String", required: true },// };

友達のリストの取得

JavaScript

const { RelationshipsApi } = require("@unity-services/friends-1.0");module.exports = async ({ params, context, logger }) => {  const relationshipsApi = new RelationshipsApi({ accessToken: context.accessToken });  try {    const list = await relationshipsApi.getRelationships(10, 0, true, true, ["FRIEND_REQUEST", "FRIEND"]);    logger.info(`Retrieved relationships: ${JSON.stringify(list.data)}`)    return list.data[0].members;  } catch (err) {    logger.error("Error while retrieving relationships", { "error.message": err.message });  }}

{    "output": [        {            "created": "2023-09-18T14:46:34.74Z",            "expires": null,            "id": "5774e898-a078-4f92-9f0a-4c9beeb6d1bb",            "members": [                {                    "id": "0gvQingjjBwpZhkUJfeoKnFUkD4T"                }            ],            "type": "FRIEND_REQUEST"        }    ]}

プレイヤーデータの操作

Cloud Code としての認証

accessToken

serviceToken

const cloudSaveApi = new DataApi(context);

context

serviceToken

ServiceToken

Cloud Save を使用した上位 5 人のプレイヤーデータの更新

1. Leaderboards サービス を使用してリーダーボードを作成します。
2. リーダーボードに一部のプレイヤースコアを載せます。

JavaScript

const { LeaderboardsApi } = require("@unity-services/leaderboards-1.1");const { DataApi } = require("@unity-services/cloud-save-1.4");module.exports = async ({ params, context, logger }) => {  const leaderboardsApi = new LeaderboardsApi(context);  const cloudSaveApi = new DataApi(context);  let result;  try {    result = await leaderboardsApi.getLeaderboardScores(context.projectId, params.leaderboardId, 0, 5);  } catch (err) {    logger.error("Failed to retrieve players from the leaderboard", {"error.message": err.message}, {"leaderboardId" : params.leaderboardId});    throw err;  }  if (result.len != 0) {    // Set Cloud Save data for every player    const promises = result.data.results.map(async (score) => {      try {        await cloudSaveApi.setItem(context.projectId, score.playerId, {          key: "ReachedTop5",          value: true,        });      } catch (err) {        logger.error("Failed to update Cloud Save data", {"error.message": err.message}, {"affectedPlayerId" : score.playerId});        return;      }    });    await Promise.all(promises);  }};// Uncomment the code below to enable the inline parameter definition// - Requires Cloud Code JS dev environment setup with NodeJS (https://docs.unity3d.com/Packages/com.unity.services.cloudcode@latest/index.html?subfolder=/manual/Authoring/javascript_project.html)//// module.exports.params = {//   leaderboardId: { type: "String", required: true },// };

Economy を使用してロビー内のすべてのプレイヤーに報酬を与える

1. Lobby サービス を使用してロビーを作成します。
2. ロビーにプレイヤーを配置します。
3. Economy サービスで通貨を 作成 および 公開 します。

JavaScript

const { LobbyApi } = require("@unity-services/lobby-1.2");const { CurrenciesApi, ConfigurationApi } = require("@unity-services/economy-2.4");module.exports = async ({ params, context, logger }) => {  const lobbyApi = new LobbyApi(context);  let result;  try {    // Get and return the lobby.    result = await lobbyApi.getLobby(params.lobbyId, "cloud-code");  } catch (err) {    logger.error("Failed to retrieve players from the Lobby", {"error.message": err.message}, {"lobbyId" : params.lobbyId});    throw err;  }  const currenciesApi = new CurrenciesApi(context);  const configApi = new ConfigurationApi(context);  if (result.len != 0) {    // Reward currency to every player    const promises = result.data.players.map(async (player) => {      try {        // Retrieve the player config to get the configAssignmentHash.        // This is needed to ensure the currency is synced        var config = await configApi.getPlayerConfiguration({          playerId: player.id,          projectId: context.projectId,        });        await currenciesApi.incrementPlayerCurrencyBalance({          currencyId: params.currencyId,          playerId: player.id,          projectId: context.projectId,          configAssignmentHash: config.data.metadata.configAssignmentHash,          currencyModifyBalanceRequest: { amount: params.amount }        });      } catch (err) {        logger.error("Failed to increment currency", {"error.message": err.message}, {"currencyId" : params.currencyId});        throw err;      }    });    await Promise.all(promises);  }};// Uncomment the code below to enable the inline parameter definition// - Requires Cloud Code JS dev environment setup with NodeJS (https://docs.unity3d.com/Packages/com.unity.services.cloudcode@latest/index.html?subfolder=/manual/Authoring/javascript_project.html)//// module.exports.params = {//   lobbyId: { type: "String", required: true },//   currencyId: { type: "String", required: true },//   amount: { type: "Numeric", required: true },// };