[神奇代码岛】皮肤功能使用

news2024/11/20 11:48:16

前言

最近有很多人在制作地图的时候，因该会用到皮肤的功能，但是皮肤操作只知道UI操作，但缺点是，只能设置地图默认皮肤，根本都做不到想要的什么皮肤购买功能，自主穿戴功能，而API官方又放在非常隐蔽的位置，非常难寻找，所以今天我就教各位创作者此功能怎么用？

UI控制

虽说UI控制只能设置默认皮肤，但是我觉得有些刚入坑新岛的岛民因该还不知道怎么换肤，所以我先来说说UI控制

设为默认皮肤

点击地图上方菜单的玩家一栏

选择自己喜欢的皮肤，点击右上角三个点，然后点击设为默认皮肤

此时运行，你就会发现，皮肤变成我们所设置的皮肤

取消设置默认皮肤

前面操作还是样

点击取消设为默认皮肤，这样运行之后皮肤就变成原来的皮肤了

代码控制（API操作）

皮肤转换操作我觉得需要一个控制器，那就用模型吧

现在地图中放置一个模型，如图

之前学过API的岛民，应该知道，想要控制模型，就必须要先获取模型，并将其赋值给一个常量，用来方便后面调用模型

const controldesk = world.querySelector("#基地操作台-1")//绑定模型
controldesk.enableInteract = true;//允许模型可以与玩家交互
controldesk.onInteract(({entity})=>{
    //皮肤操作代码（下文细讲）
})

设置头部皮肤

entity.player.skin.head = '皮肤名字';

设置躯干皮肤

entity.addTagplayer.skin.torso = '皮肤名字';

设置头部皮肤

entity.player.skin.head = '皮肤名字'

将某个部位设置成玩家原有的皮肤

操作很简单，只需要将指定部位的值设置为undefined

entity.player.skin.head = undefined;
entity.player.skin.torso = undefined;
entity.player.skin.head = undefined

全身体应用一款皮肤

entity.player.setSkinByName("皮肤名称")

脱下皮肤并穿上玩家原有的皮肤

entity.player.resetToDefaultSkin()

展示API

以上就是我认为比较常用的API，接下来我将展示官方原API，包括所有关于代码控制皮肤的API

skin

SkinDescription

此玩家的皮肤配置，用于管理当前玩家皮肤的展示。通过此处修改皮肤不会影响皮肤的隐藏状态，设置前是隐藏的，设置后也还是隐藏着。

皮肤不存在&非法参数

当皮肤名称不存在于项目皮肤库或不符合类型定义时，无事发生，并会在控制台打印警告。

示例

//...假设以某种方式得到了player对象，项目皮肤库中有 Example 和 Example2 两套皮肤

// 设置玩家头部使用一个叫 Example 的皮肤套装
player.skin.head = 'Example';
// 设置玩家躯干使用一个叫 Example2 的皮肤套装
player.skin.torso = 'Example2';
// 不小心把head又设置了一个项目中没有的皮肤套装名 WrongSkin
player.skin.head = 'WrongSkin'; // 这里会在控制台打印警告，且不会产生任何效果
// 获取玩家当前皮肤
const skin = player.skin; 
// 此时 skin 为 { head:'Example', torso: 'Example2'}
// 表现为一个头部为Example，躯干为Example2，剩余部位为玩家自己的皮肤。
// 而设置错误的皮肤套装名不会生效，也不会覆盖原有的值。

player.skin.head = undefined; // 将头部展示为玩家自己的皮肤。

setSkinByName

(skinName:string) : void

将指定皮肤套装应用到此玩家上。此方法不会影响皮肤的隐藏状态，设置前是隐藏的，设置后也还是隐藏着。

参数

skinName:string - 指定要设置的皮肤名称，将玩家皮肤整体替换为对应的皮肤。

皮肤不存在&非法参数

当皮肤名称不存在于项目皮肤库或不为字符串时，无事发生，并在控制台打印警告。

//...假设以某种方式得到了player对象，项目皮肤库中有 Example 这一套皮肤

// 设置当前 player 使用整套 Example 作为皮肤
player.setSkinByName('Example');

// 获取玩家当前皮肤
const skin = player.skin; 
// 此时 skin 内包含所有部位的属性，且值均为 Example
// { 
//   head:'Example',
//   torso: 'Example', 
//   //...以下省略所有部位，值全部都是 'Example'
// }
// 此时玩家自己的皮肤将被完全替换，任何部位都不会展示玩家自己的皮肤。