jass api详解

### JASS API 详解 JASS (Java Alike Scripting System) 是《魔兽争霸 III》游戏内的一种脚本语言系统，用于实现自定义地图的各种功能和逻辑。下面将基于提供的部分JASS API 函数进行详细解析。 #### 基础概念 在开始之前，我们先了解几个基本概念： - **API**: Application Programming Interface（应用程序编程接口）的简称，指的是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。 - **JASS**: 一种类似于 Java 的脚本语言，专门用于编写《魔兽争霸 III》中的自定义地图逻辑。 #### JASS API 分析 ##### 1. 地图速度设置 - **MAP_SPEED_FAST**: 设置游戏速度为快速模式。这通常用于加速游戏进程，使测试或者某些特殊场景下的游戏运行得更快。 ##### 2. 数学函数 - **AcosBJ**: 反余弦函数，计算一个数值的反余弦值。 - **AsinBJ**: 反正弦函数，计算一个数值的反正弦值。 - **Atan2BJ**: 双参数反正切函数，用于计算两个数值的比值的反正切值，结果介于 -π 和 π 之间。 - **AtanBJ**: 正切函数，用于计算一个数值的反正切值。 ##### 3. 英雄和单位管理 - **AddHeroXPSwapped**: 给英雄添加经验值，通常用于角色等级提升。 - **AddItemToAllStock**: 向所有库存中添加物品。此函数可能用于游戏开始时自动向玩家商店填充物品。 - **AddItemToStockBJ**: 向特定库存中添加物品。与前者类似，但可能只针对特定玩家或情况。 - **AddUnitToAllStock**: 向所有库存中添加单位。与物品类似，可以用于初始化游戏商店中的单位。 - **AddUnitToStockBJ**: 向特定库存中添加单位。更具体的版本，用于特定需求。 ##### 4. 视觉效果 - **AddLightningLoc**: 在指定位置添加闪电效果。 - **AddSpecialEffectLocBJ**: 在指定位置添加特殊视觉效果。 - **AddSpecialEffectTargetUnitBJ**: 针对目标单位添加特殊视觉效果。 ##### 5. 触发器事件 - **AddTriggerEvent**: 添加触发器事件。这是实现游戏逻辑的关键之一，通过定义不同的事件来响应游戏内的行为。 ##### 6. 资源管理 - **AddResourceAmountBJ**: 增加玩家资源数量。用于在游戏中增加玩家的金币、木材等资源。 ##### 7. 性能日志 - **AddPerfLogLabel**: 添加性能日志标签。这对于调试和优化游戏性能非常重要。 ##### 8. 盟友关系 - **ALLIANCE_HELP_REQUEST**: 请求援助联盟。当一方请求帮助时，会发送此信号给盟友。 - **ALLIANCE_HELP_RESPONSE**: 响应援助请求。接收方根据自身情况决定是否回应。 - **ALLIANCE_PASSIVE**: 被动联盟。通常表示双方不会主动攻击对方，但也不会共享资源或信息。 - **ALLIANCE_RESCUABLE**: 可救援联盟。允许一方在另一方处于危险时进行救援。 - **ALLIANCE_SHARED_ADVANCED_CONTROL**: 共享高级控制权。允许一方对另一方的单位进行更精细的控制。 - **ALLIANCE_SHARED_CONTROL**: 共享控制权。允许一方控制另一方的部分单位。 - **ALLIANCE_SHARED_SPELLS**: 共享法术。允许一方使用另一方的法术。 - **ALLIANCE_SHARED_VISION**: 共享视野。允许一方看到另一方的视野范围。 - **ALLIANCE_SHARED_VISION_FORCED**: 强制共享视野。强制共享视野，即使一方不情愿。 - **ALLIANCE_SHARED_XP**: 共享经验值。允许一方获得另一方单位的经验值。 ##### 9. 人工智能难度设置 - **AI_DIFFICULTY_INSANE**: 极难难度的人工智能设定。 - **AI_DIFFICULTY_NEWBIE**: 新手难度的人工智能设定。 - **AI_DIFFICULTY_NORMAL**: 普通难度的人工智能设定。 ##### 10. 相关操作 - **AdjustCameraBoundsForPlayerBJ**: 调整玩家摄像机边界。用于改变玩家视角的范围或边界。 - **AdjustPlayerStateBJ**: 调整玩家状态。可以用于修改玩家的状态，如生命值、经验值等。 - **AttachSoundToUnitBJ**: 将声音绑定到单位。用于为单位播放特定的声音效果。 ##### 11. 角度计算 - **AngleBetweenPoints**: 计算两点之间的角度。常用于确定单位的方向或朝向。 ##### 12. 摄像机控制 - **CAMERA_FIELD_ANGLE_OF_ATTACK**: 攻击角度字段。用于调整摄像机的角度。 - **CAMERA_FIELD_FARZ**: 远景深度字段。用于设置摄像机的远剪切平面距离。 - **CAMERA_FIELD_FIELD_OF_VIEW**: 视野角度字段。用于设置摄像机的视野角度。 - **CAMERA_FIELD_ROLL**: 滚动角度字段。用于设置摄像机的滚动角度。 - **CAMERA_FIELD_ROTATION**: 旋转角度字段。用于设置摄像机的旋转角度。 - **CAMERA_FIELD_TARGET_DISTANCE**: 目标距离字段。用于设置摄像机到目标的距离。 - **CAMERA_FIELD_ZOFFSET**: Z轴偏移量字段。用于设置摄像机在Z轴上的偏移量。 ##### 13. 摄像机噪声控制 - **CameraClearNoiseForPlayer**: 清除玩家摄像机噪声。用于减少摄像机的抖动。 - **CameraResetSmoothingFactorBJ**: 重置摄像机平滑因子。用于恢复摄像机的默认平滑设置。 - **CameraSetEQNoiseForPlayer**: 设置玩家摄像机噪声。用于调整摄像机的抖动程度。 - **CameraSetSmoothingFactorBJ**: 设置摄像机平滑因子。用于调整摄像机移动的平滑程度。 - **CameraSetSourceNoiseForPlayer**: 设置玩家摄像机来源噪声。用于调整摄像机在跟随单位时的抖动程度。 - **CameraSetTargetNoiseForPlayer**: 设置玩家摄像机目标噪声。用于调整摄像机在接近目标时的抖动程度。 ##### 14. 队伍管理 - **CaptainAtGoal**: 指挥官到达目标。用于检查指挥官是否已经到达指定目标。 - **CaptainGroupSize**: 指挥官队伍规模。用于获取指挥官当前的队伍规模。 - **CaptainInCombat**: 指挥官正在战斗。用于判断指挥官是否正在参与战斗。 - **CaptainIsEmpty**: 指挥官队伍为空。用于判断指挥官队伍是否为空。 - **CaptainIsFull**: 指挥官队伍已满。用于判断指挥官队伍是否已达到最大规模。 - **CaptainIsHome**: 指挥官在家。用于判断指挥官是否位于基地或家中。 - **CaptainReadinessHP**: 指挥官健康度。用于获取指挥官当前的生命值状态。 - **CaptainReadinessMa**: 指挥官魔法值。用于获取指挥官当前的魔法值状态。 - **CaptainRetreating**: 指挥官正在撤退。用于判断指挥官是否正在撤退。 ##### 15. 地形变化 - **ChangeElevatorHeight**: 更改升降平台高度。用于调整地图上可移动平台的高度。 - **ChangeElevatorWalls**: 更改升降平台墙壁。用于调整地图上可移动平台的墙壁设置。 以上是对提供的JASS API 函数的初步解析，这些函数覆盖了游戏中的多个方面，从单位管理、视觉效果到摄像机控制等多个维度，都是制作高质量自定义地图所必需的基础工具。开发者可以根据自己的需求灵活运用这些函数来创建独特而丰富的游戏体验。