Interface ILocalPlayer

Define LocalPlayer interface.

interface ILocalPlayer {
    avatar?: IAvatar;
    canFly: undefined | boolean;
    canHardLanding: boolean;
    canJump: boolean;
    canMove: boolean;
    canRun: boolean;
    collision: null | CollisionComponent;
    jumpMultiplier: number;
    nameTag?: INameTag;
    network?: INetwork;
    profile?: IPlayerProfile;
    respawnPosition: null | Vec3;
    spawnCount: number;
    changeAvatar(asset: Asset): void;
    fire<T>(event: T, ...args?: any[]): EventHandler;
    jump(): void;
    off<T>(event: T, listener: ILocalPlayerEvents[T]): EventHandler;
    on<T>(event: T, listener: ILocalPlayerEvents[T]): EventHandle;
    playAnimation(stateName: string, options?: {
        asset?: Asset;
        lock: boolean;
        loop: boolean;
    }): Promise<null | Asset>;
    resetToViverseAvatar(): void;
    respawn(timeout?: number): void;
    scaleAvatar(scale: number, options?: {
        sync?: boolean;
    }): void;
    stopAnimation(): void;
    teleport(destination: Vec3, rotationY?: number): void;
    turnToward(x: number | Vec2, y?: number): void;
}

Hierarchy (view full)

Properties

avatar? canFly canHardLanding canJump canMove canRun collision jumpMultiplier nameTag? network? profile? respawnPosition spawnCount

Methods

changeAvatar fire jump off on playAnimation resetToViverseAvatar respawn scaleAvatar stopAnimation teleport turnToward

Properties

Optional Readonlyavatar

avatar?: IAvatar

Get the player's avatar information.

canFly

canFly: undefined | boolean

Whenther the player can fly.

canHardLanding

canHardLanding: boolean

Whenther the player can hard land.

canJump

canJump: boolean

Whether the player can jump.

canMove

canMove: boolean

Whether the player can move.

canRun

canRun: boolean

Whether the player can run.

Readonlycollision

collision: null | CollisionComponent

Player's collision, default collision type is capsule.

jumpMultiplier

jumpMultiplier: number

Jump height multiplier.

Optional ReadonlynameTag

nameTag?: INameTag

Get the player's name tag.

Optional Readonlynetwork

network?: INetwork

Get the player's server connection information.

Optional Readonlyprofile

profile?: IPlayerProfile

Get the player's profile information.

respawnPosition

respawnPosition: null | Vec3

Player's respawn point, default is null.
When executing respawn(), first using respawnPosition as the respawn location.
If respawnPosition is null, the respawn location will be determined by the original VIVERSE CREATE mechanism (checkpoint, spawn-point tag).

ReadonlyspawnCount

spawnCount: number

Get the player's respawn count.

Methods

changeAvatar

fire

jump

  • jump(): void

  • Make the character jump in place. If successful, it will trigger the jump:start event.
    In some cases, the character may not be able to jump, such as when the character is falling, is already in a jumping state, or is affected by external forces.

    Returns void

off

on

playAnimation

  • playAnimation(stateName, options?): Promise<null | Asset>

  • Play a custom animation.

    Parameters

    • stateName: string

      The stateName of animation.

    • Optionaloptions: {
          asset?: Asset;
          lock: boolean;
          loop: boolean;
      }

      Optional parameters.

      • Optionalasset?: Asset

        Send the vrma file.

      • lock: boolean

        Lock the animation. Default is false.

      • loop: boolean

        Loop the animation. Default is false.

    Returns Promise<null | Asset>

    • Return the animation asset.

resetToViverseAvatar

respawn

  • respawn(timeout?): void

  • Send the character back to the respawn point (respawnPosition), with the respawned event triggered.
    If respawnPosition is null, the respawn location will be determined by the original VIVERSE CREATE mechanism (checkpoint, spawn-point tag).

    Parameters

    • Optionaltimeout: number

      Delay the respawn time (in milliseconds).

    Returns void

scaleAvatar

  • scaleAvatar(scale, options?): void

  • Scale the avatar model with the specified scale ratio.

    Parameters

    • scale: number

      Scale ratio

    • Optionaloptions: {
          sync?: boolean;
      }

      Optional parameters

      • Optionalsync?: boolean

        Whether to sync scaling to other players over the network. Default is true.

    Returns void

stopAnimation

teleport

  • teleport(destination, rotationY?): void

  • Teleport the character to the target location.

    Parameters

    • destination: Vec3

      Target location

    • OptionalrotationY: number

      Y-axis rotation angle

    Returns void

turnToward

  • turnToward(x, y?): void

  • Make the character face the target’s position on the horizontal plane.

    Parameters

    • x: number | Vec2

      X-coordinate of the target’s position on the horizontal plane, or the target's horizontal position.

    • Optionaly: number

      Y-coordinate of the target’s position on the horizontal plane.

    Returns void

Settings

Member Visibility

On This Page

Properties
Methods