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 在动画结束后不会生效
提示
与其他移出车辆方式不同,本函数会将车辆速度立即归零。玩家将出现在车辆顶部,位置与其在座位上的坐标一致
相关函数
- ApplyAnimation: 为玩家应用动画效果