跳到主要内容

ClearAnimations

描述

终止指定玩家当前所有动画效果,并取消其正在进行的行为任务(包括但不限于喷气背包飞行、跳伞、进入车辆过程、驾驶状态(强制移出车辆)、游泳等)

参数名说明
playerid目标玩家 ID
FORCE_SYNC:forceSync设置为SYNC_ALL将强制玩家在流式传输范围内同步动画状态(默认=SYNC_NONE,不强制同步)

返回值

本函数始终返回 true,即使指定玩家未连接

示例代码

public OnPlayerCommandText(playerid, cmdtext[])
{
if (!strcmp(cmdtext, "/清除动画", true))
{
ClearAnimations(playerid);
return 1;
}
return 0;
}

注意事项

提示

当在 ApplyAnimation 函数中使用'freeze'参数冻结动画时,ClearAnimations 在动画结束后不会生效

提示

与其他移出车辆方式不同,本函数会将车辆速度立即归零。玩家将出现在车辆顶部,位置与其在座位上的坐标一致

相关函数