API
Return to top
AvatarSettings
编辑

设置 / AvatarSettings

AvatarSettings Class
​

控制一些优化项的开启关闭

使用示例:创建一个名为"ClassExample"的脚本，放置在对象栏中，打开脚本，输入以下代码保存，运行游戏，你将在服务器Log中看到对应方法调用信息。代码如下：
ts
@Component
export default class ClassExample extends Script {

    protected onStart(): void {
       this.RoomSettings();
    }

    public RoomSettings(){
       let opt = AvatarSettings.optimizationEnabled;
       console.log("角色优化是否开启：" + opt);
    }
}
@Component
export default class ClassExample extends Script {

    protected onStart(): void {
       this.RoomSettings();
    }

    public RoomSettings(){
       let opt = AvatarSettings.optimizationEnabled;
       console.log("角色优化是否开启：" + opt);
    }
}

Table of contents ​

Accessors
​

optimizationEnabled(): boolean client
开启或关闭角色优化:通过动态限制骨架网格体组件的tick频率来限制运行动画数据的时间。

Methods
​

getAvatarForcedLOD(character: Character): number client
获取角色形象细节层次，0 表示 自动切换。 1， 2， 3 表示 3个等级，Level1细节最多。
setAvatarForcedLOD(character: Character, level: number): void client
设置角色形象细节层次，0 表示 自动切换。 1， 2， 3 表示 3个等级，Level1细节最多。
setOptimization(character: Character, useAnimationBudget: boolean, useWave: boolean): void client
开启或关闭角色优化:通过动态限制骨架网格体组件的tick频率来限制运行动画数据的时间。

Accessors ​

optimizationEnabled
​

• Static get optimizationEnabled(): boolean client

• Static set optimizationEnabled(isEnabled): void client

开启或关闭角色优化:通过动态限制骨架网格体组件的tick频率来限制运行动画数据的时间。

Returns ​

booleanboolean:角色优化是否开启,如果返回值为undefined，请检查是否在客户端调用,默认值是:true

开启或关闭角色优化:通过动态限制骨架网格体组件的tick频率来限制运行动画数据的时间。

Parameters ​

isEnabled boolean是否开启或关闭角色优化

Methods ​

getAvatarForcedLOD
​

• Static getAvatarForcedLOD(character): number client

获取角色形象细节层次，0 表示 自动切换。 1， 2， 3 表示 3个等级，Level1细节最多。

Parameters ​

character Character角色对象

Returns ​

numberlevel usage:Lod等级：0 表示 自动切换。 1， 2， 3 表示 3个等级

setAvatarForcedLOD
​

• Static setAvatarForcedLOD(character, level): void client

设置角色形象细节层次，0 表示 自动切换。 1， 2， 3 表示 3个等级，Level1细节最多。

Parameters ​

character Character角色对象
level numberLod等级：0 表示 自动切换。 1， 2， 3 表示 3个等级 range:[0, 3] type: 整形

setOptimization
​

• Static setOptimization(character, useAnimationBudget, useWave): void client

开启或关闭角色优化:通过动态限制骨架网格体组件的tick频率来限制运行动画数据的时间。

Parameters ​

character Character角色对象
useAnimationBudget boolean是否开启或关闭角色动画预算分配器
useWave boolean该参数现已弃用