Jugadores

El Jugadores módulo permite escenas para buscar jugadores en su entorno y obtener información sobre su identidad y perfiles.

const Players = require("~system/Players");

Contiene los siguientes métodos y tipos:

• function getPlayersInScene

• function getConnectedPlayers

• function getPlayerData

• interface Player

• interface UserData

Métodos

Hay dos métodos en este módulo para descubrir jugadores en la escena, y uno para obtener sus perfiles.

getPlayersInScene

Devuelve un Player array, cada uno con un userId que puede usarse en getPlayerData.

interface Request {}

interface Response {
  players: Player[];
}

function getPlayersInScene(Request): Promise<Response>;

getConnectedPlayers

interface Request {}

interface Response {
  players: Player[];
}

function getConnectedPlayers(Request): Promise<Response>;

getPlayerData

Devuelve el UserData para un usuario, si se conoce para el valor dado userId.

interface Request {
  // El identificador del usuario (para no invitados, su dirección de Ethereum).
  userId: string;
}

interface Response {
  // La información del perfil de este usuario, si está disponible.
  data?: UserData;
}

function getPlayerData(Request): Promise<Response>;

Tipos

Solo hay dos tipos en este módulo: Player y UserData.

Player

Contiene una referencia a un userId.

interface Player {
  // El identificador del usuario (para no invitados, su dirección de Ethereum).
  userId: string;
}

UserData

Contiene información (posiblemente parcial) sobre un usuario, su identidad y avatar.

World Explorers obtienen esta información a través de la sistema de contenido.

El definición de entidad de perfil detalla todos estos campos y más. Aunque la estructura y las claves de UserData son ligeramente diferentes, el significado de cada campo es el mismo.

export interface UserData {
  // El identificador del usuario (es decir, su dirección de Ethereum).
  userId: string;

  // Un nombre para llamarlo en la UI.
  displayName: string;

  // La clave pública de Ethereum con la que firman.
  publicKey?: string;

  // Si tienen habilitada la funcionalidad web3.
  hasConnectedWeb3: boolean;

  // La versión secuencial de esta información, incrementada en cada actualización del usuario.
  version: number;

  // Información sobre su avatar, si está disponible.
  avatar?: {
    // Referencias a los assets necesarios para renderizar este avatar.
    bodyShape: string;
    wearables: string[];

    // Matices de color RGB/RGBA codificados en hexadecimal para diferentes partes del cuerpo.
    skinColor: string;
    hairColor: string;
    eyeColor: string;

    // Identificadores de archivo para las "fotos" de este avatar.
    snapshots?: {
      face256: string;
      body: string;
    };
  };
}