meta data for this page
  •  

📚 差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:client:player [2023/12/02 15:31] – bibiboxsscripting:client:player [2025/05/27 19:21] (当前版本) – bibiboxs
行 14: 行 14:
 > 当某个玩家**取消绑定**了一个实体对象（开始控制角色）时调用。 > 当某个玩家**取消绑定**了一个实体对象（开始控制角色）时调用。
  
 +
 +
 +### OnPlayerFocusEntityChange( player, entity )
 +
 +> 当玩家焦点对象发生改变时调用。
 +
 +```javascript
 +function OnPlayerFocusEntityChange( player: Player, entity: Entity )
 +```
 +
 +
 +
 +### OnPlayerVoiceStateChange( player, state )
 +
 +> 当玩家语音聊天状态发生改变时调用（正在语音聊天）。
 +
 +```javascript
 +function OnPlayerVoiceStateChange( player: Player, state: bool )
 +```
  
  
行 23: 行 42:
  
 ```javascript ```javascript
-DLog(Player.Local.Name); //Output self player name+if(Player.Local) DLog(Player.Local.Name); //Output self player name
 ``` ```
  
行 57: 行 76:
 player.IsLocal: bool player.IsLocal: bool
 ``` ```
 +
 +
 +
 +### player.IsComplete
 +
 +> 获取玩家是否完全加载完毕。
 +
 +```javascript
 +player.IsComplete: bool
 +```
 +
 +
 +
 +### player.IsObserver
 +
 +> 获取玩家是否当前为相机观察模式（`Client.Camera.IsObserver`）。
 +
 +```javascript
 +player.IsObserver: bool
 +```
 +
 +
 +
 +### player.CameraMode
 +
 +> 获取（只读）玩家相机模式（参考`Client.Camera.Mode`）。
 +
 +```javascript
 +player.CameraMode: int
 +```
 +
  
  
行 99: 行 149:
  
  
-### player.RaycastPos+### player.VoiceState
  
-> 获取玩家焦点实时位置（鼠标世界坐标），受视角碰撞遮挡影响，包含高度Y轴信息。+> 获取玩家语音聊天状态（是否正在语音聊天）。 
 +>
  
 ```javascript ```javascript
-player.RaycastPos: Vector+player.VoiceState: bool
 ``` ```
 +
 +
 +
 +## Static Function
 +
 +### Player.Find()
 +
 +> 寻找一个玩家实例（通过ID），不存在则返回`null`。
 +
 +```javascript
 +function Player.Find( id: int ): Player
 +```
 +
 +
 +
 +### Player.Search()
 +
 +> 寻找一个玩家实例（通过模糊查找，通常根据玩家名称\ID，不区分大小写），不存在则返回`null`。
 +
 +```javascript
 +function Player.Search( any: string ): Player
 +```
 +
 +```javascript
 +//Players: "Alnny", "Tommy", "Tom"
 +Player.Search("Tom"); //Tom（完整匹配）
 +Player.Search("Tomm"); //Tommy（相似匹配）
 +Player.Search("To"); //Tommy（以最先搜索到的为主）
 +Player.Search("0"); //By ID
 +```
 +
 +
 +
 +
 +### Player.FindByUUID()
 +
 +> 寻找一个玩家实例（通过UUID），不存在则返回`null`。
 +
 +```javascript
 +function Player.FindByUUID( uuid: string ): Player
 +```
 +
 +
 +
 +### Player.GetCount()
 +
 +> 获取当前所有存在玩家数量。
 +
 +```javascript
 +function Player.GetCount(): int
 +```
 +
 +
 +
 +### Player.Get()
 +
 +> 获取当前存在的指定索引玩家，通常搭配`GetCount()`遍历使用。
 +
 +```javascript
 +function Player.Get( index: int ): Player
 +```
 +
 +
 +
 +## 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
 +```
 +
 +
 +