meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:client:player [2024/08/08 05:56] – bibiboxsscripting:client:player [2025/05/27 19:21] (当前版本) – bibiboxs
行 13: 行 13:
  
 > 当某个玩家**取消绑定**了一个实体对象（开始控制角色）时调用。 > 当某个玩家**取消绑定**了一个实体对象（开始控制角色）时调用。
 +
 +
 +
 +### OnPlayerFocusEntityChange( player, entity )
 +
 +> 当玩家焦点对象发生改变时调用。
 +
 +```javascript
 +function OnPlayerFocusEntityChange( player: Player, entity: Entity )
 +```
  
  
行 30: 行 40:
  
 > 获取本地玩家实例对象（本地玩家自身）。 > 获取本地玩家实例对象（本地玩家自身）。
->  
-> **==注意：在专用服务器模式（`BatchMode`）下，通过服务器自身脚本访问此属性，将会得到一个空值`Null`，因为专用服务器本身并不包含本地玩家。==** 
- 
-[note2] 
-由于**专用服务器模式**本地空玩家的特殊属性，`Character`类对象提供了一个快捷检测方法：`character.IsLocal`判断是否为本地玩家角色，此方法会自动检测`Null`而不会触发异常。 
-[/note] 
  
 ```javascript ```javascript
行 91: 行 95:
 ```javascript ```javascript
 player.IsObserver: bool player.IsObserver: bool
 +```
 +
 +
 +
 +### player.CameraMode
 +
 +> 获取（只读）玩家相机模式（参考`Client.Camera.Mode`）。
 +
 +```javascript
 +player.CameraMode: int
 ``` ```
  
行 160: 行 174:
 ### Player.Search() ### Player.Search()
  
-> 寻找一个玩家实例（通过模糊查找，通常根据玩家名称，不区分大小写），不存在则返回`null`。+> 寻找一个玩家实例（通过模糊查找，通常根据玩家名称\ID，不区分大小写），不存在则返回`null`。
  
 ```javascript ```javascript
行 171: 行 185:
 Player.Search("Tomm"); //Tommy（相似匹配） Player.Search("Tomm"); //Tommy（相似匹配）
 Player.Search("To"); //Tommy（以最先搜索到的为主） Player.Search("To"); //Tommy（以最先搜索到的为主）
 +Player.Search("0"); //By ID
 ``` ```
  
行 204: 行 219:
 ``` ```
  
 +
 +
 +## Function
 +
 +### player.GetObserver()
 +
 +[note2]
 +此方法已过时，已在新版本移除。
 +[/note]
 +
 +> 获取玩家视角观察对象（`Client.Camera.Target`），如不存在则返回`null`。
 +
 +```javascript
 +function player.GetObserver(): Character
 +```
 +
 +
 +
 +### player.TestVisiblePoint()
 +
 +> 检测玩家相机是否能看到指定坐标（模糊检测，边缘检测并非绝对准确，模拟本地`Camera.TestVisiblePoint()`）。
 +
 +```javascript
 +function player.TestVisiblePoint( pos: Vector ): bool
 +```