# 玩家管理接口 Player

在使用玩家接口前需先创建玩家管理对象,方法如下:(此处已废弃)

local Player = class.Player.new()

具体函数名及描述如下:

序号 函数名 函数描述
1 getAttr(...) 玩家属性获取
2 setAttr(...) 玩家属性设置
3 getHostUin(...) 获取房主uin
4 isMainPlayer(...) 是否是本地玩家
5 getMainPlayerUin(...) 获取本地玩家的uin
6 getGameResults(...) 获取玩家是否胜利
7 setGameResults(...) 设置玩家是否胜利
8 getGameScore(...) 获取玩家分数
9 setGameScore(...) 设置玩家分数
10 getGameRanking(...) 获取玩家排名
11 setGameRanking(...) 设置玩家分数
12 gainItems(...) 添加道具至玩家背包
13 teleportHome(...) 传送到出生点
14 getCurToolID(...) 获取玩家手持道具
15 getNickname(...) 获取玩家手昵称
16 removeBackpackItem(...) 移除玩家背包道具
17 getDieTimes(...) 获取玩家死亡次数
18 getLeftLifeNum(...) 获取玩家生命数量
19 setTeam(...) 设置玩家队伍
20 getTeam(...) 获取玩家队伍
21 getFoodLevel(...) 获取玩家饱食度(体力值)
22 setFoodLevel(...) 设置玩家饱食度
23 getCurShotcut(...) 获取玩家快捷栏索引
24 onCurToolUsed(...) 玩家使用手持道具
25 setSkillCD(...) 设置道具技能时间
26 reviveToPos(...) 玩家在指定位置复活
27 setRevivePoint(...) 设置玩家复活点
28 mountActor(...) 使玩家骑上坐骑
29 playAct(...) 使玩家播放表情
30 notifyGameInfo2Self(...) 使玩家显示飘窗文字
31 useItem(...) 玩家使用道具
32 rotateCamera(...) 玩家旋转摄像机角度
33 changeViewMode(...) 玩家改变视角
34 setActionAttrState(...) 设置玩家行为属性状态
35 checkActionAttrState(...) 设置玩家行为属性状态
36 isEquipByResID(...) 设置玩家是否装备了某件装备
37 setPosition(...) 设置玩家位置
38 getAimPos(...) 获取玩家准心位置
39 setItemAttAction(...) 设置玩家道具设置属性
40 playMusic(...) 对玩家播放背景音乐
41 stopMusic(...) 玩家停止播放背景音乐
42 setGameWin(...) 使玩家胜利
43 openDevStore(...) 玩家打开开发者商店(仅开发者可用)
44 openDevStoreNew(...) 玩家打开开发者商店(仅开发者可用)
45 openDevStoreTab(...) 玩家打开开发者商店并指定页签(仅开发者可用)
46 getPropsType(...) 玩家手持道具的类型
47 playAdvertisingCallback(...) 玩家播放开发者广告(仅开发者可用)
48 setCheckBoxScale(...) 设置检测掉落物半径
49 openBoxByPos(...) 打开可以操作的箱子
50 forceOpenBoxUI(...) 玩家强制打开UI界面
51 openDevGoodsBuyDialog(...) 打开开发者商店商品购买弹框
52 openUIView(...) 打开一个UI界面
53 hideUIView(...) 隐藏一个UI界面
54 changPlayerMoveType(...) 改变玩家移动方式
55 shakeCamera(...) 抖动玩家镜头
56 stopShakeCamera(...) 停止抖动玩家镜头
57 playQQMusic(...) 玩家播放qq音乐
58 operateQQMusic(...) 暂停/恢复/停止玩家的QQ音乐
59 OpenAppraiseView(...) 打开评价界面
60 OpenCollectionView(...) 打开收藏界面
61 IsMiniVip(...) 判断玩家是否是迷你会员(阻塞接口)
62 SendFriendApply(...) 发送好友申请(相同玩家请求间隔必须大于10s)
63 HasFriend(...) 判断两个玩家是否是迷你会员(阻塞接口)
64 PlayActInHand(...) 玩家手持微缩模型道具播放动作
65 OpenBuiltinRank(...) 打开内置排行榜
66 HideBuiltinRank(...) 隐藏内置排行榜

# getAttr

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家属性获取
  • 具体使用案例如下:
--获取房主的生命值
--第一个参数0为游戏玩家id或玩家迷你号,0是房主
--第二个参数2是属性:当前生命值,具体可以在“游戏数据类型”的“玩家属性枚举”中查看
local result,value=Player:getAttr(0,2)
--在聊天框显示
Chat:sendSystemMsg("房主当前生命值为:"..value)

# setAttr

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家属性设置
  • 具体使用案例如下:
--设置房主的生命上限
--第一个参数0为游戏玩家id或玩家迷你号,0是房主
--第二个参数1是属性:生命上限,具体可以在“游戏数据类型”的“玩家属性枚举”中查看
--第三个参数500是需要设置属性的值
Player:setAttr(0,1,500)
--在聊天框显示
Chat:sendSystemMsg("房主生命上限被设置为500")

# getHostUin

  • 参数及类型: 无
  • 返回值及类型:
  • 该方法的主要作用: 获取房主uin
  • 具体使用案例如下:
--获取房主迷你号
local result,uin=Player:getHostUin()
--在聊天框显示
Chat:sendSystemMsg("房主迷你号为:"..uin)

# isMainPlayer

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 是否是本地玩家
  • 具体使用案例如下:
--判断某迷你号是不是本地玩家(房主)
--参数1000是需要判断的迷你号
local result=Player:isMainPlayer(1000)
if result==0 then--如果是
	--在聊天框显示
	Chat:sendSystemMsg("1000是本地玩家(房主)")
else--如果不是
	--在聊天框显示
	Chat:sendSystemMsg("1000不是本地玩家(房主)")
end

# getMainPlayerUin

  • 参数及类型: 无
  • 返回值及类型:
  • 该方法的主要作用: 获取本地玩家的uin
  • 具体使用案例如下:
--获取本地玩家(房主)迷你号
local result,uin=Player:getMainPlayerUin()
--在聊天框显示
Chat:sendSystemMsg("本地玩家(房主)迷你号为:"..uin)

# getGameResults

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家是否胜利
  • 具体使用案例如下:
--获取玩家的游戏状态或比赛结果
--参数0是玩家id或玩家迷你号,0是房主
--返回值可能是:0游戏中 1游戏胜利 2游戏结束
local result,value=Player:getGameResults(0)
Chat:sendSystemMsg("当前房主的游戏状态是(0游戏中 1游戏胜利 2游戏结束):"..value)

# setGameResults

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家是否胜利
  • 具体使用案例如下:
--设置玩家的游戏状态或比赛结果
--第一个参数是玩家id或玩家迷你号,0是房主
--第二个参数为游戏状态或比赛结果:0游戏中 1游戏胜利 2游戏结束
Player:setGameResults(0,1)
--在聊天框显示
Chat:sendSystemMsg("设置房主游戏胜利")

# getGameScore

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家分数
  • 具体使用案例如下:
--当玩家做动画表情时在聊天框显示房主游戏分数
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--获取房主的游戏分数
	--参数0为玩家id或玩家迷你号,0是房主
	local result,value=Player:getGameScore(0)
	--在聊天框显示
	Chat:sendSystemMsg("房主当前的游戏分数为"..value)
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# setGameScore

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家分数
  • 具体使用案例如下:
--把房主的分数设为100(玩家分数不是玩家所在队伍的分数,要注意区别。队伍分数可查阅Team)
--第一个参数是玩家id或玩家迷你号,0是房主
--第二个参数为要设置的游戏分数
Player:setGameScore(0,100)
--在聊天框显示
Chat:sendSystemMsg("房主的游戏分数被设置为了100(玩家分数不是玩家所在队伍的分数)")

# getGameRanking

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家排名
  • 具体使用案例如下:
--获取玩家的游戏排行
--参数0为玩家id或玩家迷你号,0是房主
local result,rank=Player:getGameRanking(0)
--在聊天框显示
Chat:sendSystemMsg("房主的游戏排行为"..rank)

# setGameRanking

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家分数
  • 具体使用案例如下:
--设置房主的排行为第一名
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为玩家排行
Player:setGameRanking(0,1)
--在聊天框显示
Chat:sendSystemMsg("房主排行被设置为了第一名")

# gainItems

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 添加道具至玩家背包
  • 具体使用案例如下:
--给玩家背包增加某道具或物品
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数是添加物品的id,1是基岩
--第三个参数是添加的物品数量
--最后一个参数是优先快捷栏还是背包栏:1优先快捷栏 2优先背包栏
Player:gainItems(0,1,10,1)
--在聊天框显示
Chat:sendSystemMsg("给房主快捷栏或背包增加了10个基岩")

# teleportHome

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 传送到出生点
  • 具体使用案例如下:
--每当玩家做动画表情房主都会被传送回出生点
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--把玩家传送至出生点,参数为玩家id或玩家迷你号,0是房主
	Player:teleportHome(0)
	--在聊天框显示
	Chat:sendSystemMsg("房主被传送到了出生点")
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# getCurToolID

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家手持道具
  • 具体使用案例如下:
--获取玩家手持物品的id,参数为玩家id或玩家迷你号,0是房主
local result,id=Player:getCurToolID(0)
--在聊天框显示
Chat:sendSystemMsg("房主当前拿着的物品的id为"..id)

# getNickname

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家手昵称
  • 具体使用案例如下:
--获取玩家昵称,参数为玩家id或玩家迷你号,0是房主
local result,name=Player:getNickname(0)
--在聊天框显示
Chat:sendSystemMsg("房主的昵称为:"..name)

# removeBackpackItem

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 移除玩家背包道具
  • 具体使用案例如下:
--移除玩家背包里的物品
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为要移除的物品id,101是土块
--第三个参数为要移除的物品数量
Player:removeBackpackItem(0,101,10)
--在聊天框显示
Chat:sendSystemMsg("移除了房主背包里的10个土块")

# getDieTimes

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家死亡次数
  • 具体使用案例如下:
--每当玩家做动画表情,聊天框显示房主死亡次数
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--获取玩家死亡次数,参数为玩家id或玩家迷你号,0是房主
	local result,value=Player:getDieTimes(0)
	--在聊天框显示
	Chat:sendSystemMsg("房主的死亡次数为"..value)
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# getLeftLifeNum

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家生命数量
  • 具体使用案例如下:
--每当玩家做动画表情,聊天框显示房主剩余生命数
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--获取玩家剩余生命数,参数为玩家id或玩家迷你号,0是房主
	local result,value=Player:getLeftLifeNum(0)
	--在聊天框显示
	Chat:sendSystemMsg("房主剩余生命数为"..value)
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# setTeam

  • 参数及类型:
    • objid:number玩家Uin
    • teamid:number队伍ID(0无队伍,1-6队伍值)
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家队伍
  • 具体使用案例如下:
--设置玩家队伍
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为要设置为的队伍
Player:setTeam(0,2)
--在聊天框显示
Chat:sendSystemMsg("房主被设置为第二队")

# getTeam

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家队伍
  • 具体使用案例如下:
--获取玩家所在队伍,参数为玩家id或玩家迷你号,0是房主
local result,value=Player:getTeam(0)
--在聊天框显示
Chat:sendSystemMsg("房主所在队伍为:"..value)

# getFoodLevel

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家饱食度(体力值)
  • 具体使用案例如下:
--获取玩家饱食度,参数为玩家id或玩家迷你号,0是房主
local result,value=Player:getFoodLevel(0)
--在聊天框显示
Chat:sendSystemMsg("房主当前饱食度为"..value)

# setFoodLevel

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家饱食度
  • 具体使用案例如下:
--设置玩家饱食度
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为要设置的饱食度
Player:setFoodLevel(0,100)
--在聊天框显示
Chat:sendSystemMsg("设置房主的饱食度为100")

# getCurShotcut

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家快捷栏索引
  • 具体使用案例如下:
--获取玩家当前选中的快捷栏位置,参数为玩家id或玩家迷你号,0是房主
local result,scutIdx=Player:getCurShotcut(0)
--在聊天框显示
Chat:sendSystemMsg("房主当前选中的快捷栏为:"..scutIdx)

# onCurToolUsed

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家使用手持道具
  • 具体使用案例如下:
--设置玩家手持物品的消耗
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为消耗的道具数量(貌似没效果)
Player:onCurToolUsed(0,1)
--在聊天框显示
Chat:sendSystemMsg("房主当前选中的物品被移除了1个")

# setSkillCD

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置道具技能时间
  • 具体使用案例如下:
--每当玩家做动画表情,房主的钻石剑CD都会变为100秒
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--设置玩家的道具CD
	--第一个参数为玩家id或玩家迷你号,0是房主
	--第二个参数为道具id,12005是能量剑(钻石剑)
	--第三个参数为设置的技能冷却时长
	Player:setSkillCD(0,12005,100)
	--在聊天框显示
	Chat:sendSystemMsg("房主的钻石剑技能冷却时间被设置为了100秒")
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# reviveToPos

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家在指定位置复活
  • 具体使用案例如下:
--复活玩家到指定位置(貌似没效果,也许只对死亡玩家有效)
--第一个参数为玩家id或玩家迷你号,0是房主
--后三个参数为复活到坐标
Player:reviveToPos(0,50,7,50)
--在聊天框显示
Chat:sendSystemMsg("把房主复活到(50,50)高度7的位置")

# setRevivePoint

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家复活点
  • 具体使用案例如下:
--设置玩家的复活点坐标
--第一个参数为玩家id或玩家迷你号,0是房主
--后三个参数为设置的复活点坐标
Player:setRevivePoint(0,50,7,50)
--在聊天框显示
Chat:sendSystemMsg("房主复活点被设置在了(50,50)高度7的位置")

# mountActor

  • 参数及类型:
    • objid:number玩家Uin
    • objid:number坐骑ID(传入0,登下坐骑)
  • 返回值及类型:
  • 该方法的主要作用: 使玩家骑上坐骑
  • 具体使用案例如下:
local code = Player:mountActor(playerid, objid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# playAct

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 使玩家播放表情
  • 具体使用案例如下:
--让玩家播放动画表情
--第一个参数为玩家迷你号
--第二个参数为动作表情id,具体可以在“迷你世界ID查询”的“动作表数据”查询
Player:playAct(1000,1)
--在聊天框显示
Chat:sendSystemMsg("让迷你号为1000的玩家播放打招呼动作")

# notifyGameInfo2Self

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 使玩家显示飘窗文字
  • 具体使用案例如下:
--对玩家显示飘窗提示框
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数是显示的文本内容
Player:notifyGameInfo2Self(0,"这里是飘窗文字内容")

# useItem

  • 参数及类型:
    • objid:number玩家Uin
    • itemid:number道具类型
    • status:number使用状态(0开始,1结束,2取消)
    • onshift:boolean是否使用shift键
  • 返回值及类型:
  • 该方法的主要作用: 玩家使用道具
  • 具体使用案例如下:
local code = Player:useItem(objid, itemid, status, onshift)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# rotateCamera

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家旋转摄像机角度
  • 具体使用案例如下:
--设置玩家视角方向
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为水平方向旋转角度,正北为0,由北向东为正方向
--第三个参数为俯仰角,90为俯视,-90为仰视,之间的角度可任意设置
Player:rotateCamera(0,90,90)
--在聊天框显示
Chat:sendSystemMsg("房主视角被设置为面向正东、俯视")

# changeViewMode

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家改变视角
  • 具体使用案例如下:
--设置玩家视角模式
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为视角模式:0主视角 1背视角 2正视角 3俯视角 4俯视角 5自定义视角
--第三个参数为是否锁定视角:true锁定 false不锁定
Player:changeViewMode(0,0,true)
--在聊天框显示
Chat:sendSystemMsg("锁定房主视角为第一人称主视角")

# setActionAttrState

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家行为属性状态
  • 具体使用案例如下:
--设置玩家行为属性状态
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数是行为属性值,1是“移动”,具体可以在“游戏数据类型”的“玩家属性设置”里查看
--第三个参数为“是否可以”,true可以 false不可以
Player:setActionAttrState(0,1,false)
--在聊天框显示
Chat:sendSystemMsg("设置房主不可移动")

# checkActionAttrState

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家行为属性状态
  • 具体使用案例如下:
--获取玩家的行为属性状态
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数是行为属性值,1是“移动”,具体可以在“游戏数据类型”的“玩家属性设置”里查看
local result=Player:checkActionAttrState(0,1)
if result==0 then--如果可以
	--在聊天框显示
	Chat:sendSystemMsg("房主可以移动")
else--如果不可以
	--在聊天框显示
	Chat:sendSystemMsg("房主不可移动")
end

# isEquipByResID

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家是否装备了某件装备
  • 具体使用案例如下:
local code = Player:isEquipByResID(objid, itemid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# setPosition

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家位置
  • 具体使用案例如下:
--设置玩家到某坐标
--第一个参数为玩家id或玩家迷你号,0是房主
--后三个参数为设置到的坐标
Player:setPosition(0,100,7,100)
--在聊天框显示
Chat:sendSystemMsg("房主被设置到了(100,100)高度7的位置")

# getAimPos

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取玩家准心位置
  • 具体使用案例如下:
--获取玩家准心坐标,参数为玩家id或玩家迷你号,0是房主
local result,x,y,z=Player:getAimPos(0)
--在聊天框显示
Chat:sendSystemMsg("房主当前准心坐标为("..x..","..y..","..z..")")
--输出到控制台
print("房主当前准心坐标为("..x..","..y..","..z..")")

# setItemAttAction

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置玩家道具设置属性
  • 具体使用案例如下:
--设置玩家的道具的操作属性
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为要设置的道具的id,101是土块
--第三个参数为属性值:1不可丢弃 2不可掉落
--最后一个参数为是否开启属性:true开启 false关闭
Player:setItemAttAction(0,101,1,true)
--在聊天框显示
Chat:sendSystemMsg("房主被设置为不可丢弃土块")

# playMusic

  • 参数及类型:
    • objid:number玩家Uin
    • musicId:string声音ID
    • volume:number声音大小
    • pitch:number::声音音调
    • isLoop:是否循环
  • 返回值及类型:
  • 该方法的主要作用: 对玩家播放背景音乐
  • 具体使用案例如下:
--对玩家播放音乐
--第一个参数为玩家id或玩家迷你号,0是房主
--第二个参数为音乐id,具体可以在“迷你世界ID表查询”的“音效表数据”里查看
--第三个参数为播放音量
--第四个参数为播放音高
--最后一个参数为是否循环播放
Player:playMusic(0,10713,100,1,false)
--在聊天框显示
Chat:sendSystemMsg("开始对房主播放音乐10713")

# stopMusic

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家停止播放背景音乐
  • 具体使用案例如下:
--对房主播放音乐10713
Player:playMusic(0,10713,100,1,false)
--在聊天框显示
Chat:sendSystemMsg("开始对房主播放音乐10713,做动画表情即可停止播放")
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--停止对玩家播放音乐,参数为玩家id或玩家迷你号,0是房主
	Player:stopMusic(0)
	--在聊天框显示
	Chat:sendSystemMsg("停止对房主播放音乐")
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# setGameWin

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 使玩家胜利
  • 具体使用案例如下:
--每当玩家做动画表情,让指定迷你号的玩家获胜
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--指定迷你号玩家获胜,参数为玩家迷你号
	local result=Player:setGameWin(1000)
	if result==0 then--如果房间里存在迷你号为1000的玩家
		--在聊天框显示
		Chat:sendSystemMsg("设置玩家1000获胜")
	else--如果房间里没有迷你号为1000的玩家
		--在聊天框显示
		Chat:sendSystemMsg("房间里没有玩家迷你号为1000")
	end
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# openDevStore

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家打开开发者商店(仅开发者可用)
  • 具体使用案例如下:
--每当玩家做动画表情,为指定玩家打开开发者商店
--当玩家做动画表情时执行此函数
local function Player_PlayAction(event)
	--为指定玩家打开开发者商店,参数为玩家id或玩家迷你号,0是房主
	Player:openDevStore(0)
	--在聊天框显示
	Chat:sendSystemMsg("为房主打开了开发者商店")
end
--注册一个动画表情监听器,事件发生时执行上面的函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],Player_PlayAction)

# openDevStoreNew

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家打开开发者商店(仅开发者可用)
  • 具体使用案例如下:
local code = Player:openDevStoreNew(objid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# openDevStoreTab

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家打开开发者商店并指定页签(仅开发者可用)
  • 具体使用案例如下:
local code = Player:openDevStoreTab(objid, page, name)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# getPropsType

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家手持道具的类型
  • 具体使用案例如下:
local code, itemid = Player:getPropsType(playerid)
if code == ErrorCode.OK then
	print('执行成功', code, itemid )
else
	print('执行失败')
end

# playAdvertisingCallback

  • 参数及类型:
    • objid:number玩家ID
    • adname:string广告名称
    • callback:function更新回调(function(code/错误码,adname/广告名))
  • 返回值及类型:
  • 该方法的主要作用: 玩家播放开发者广告(仅开发者可用)
  • 具体使用案例如下:
local playcallback = function(ret,...)
	if ret then
		print("播放广告完成",...)
	else
		print("播放广告失败",...)
	end
end
local function func_event(param)
	local playerid = CurEventParam.TriggerByPlayer
	local result = Player:playAdvertisingCallback(playerid,'播放广告',playcallback)
end
ScriptSupportEvent:registerEvent('Player.PlayAction', func_event)

# setCheckBoxScale

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置检测掉落物半径
  • 具体使用案例如下:
local code = Player:setCheckBoxScale(objid, range)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# openBoxByPos

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开可以操作的箱子
  • 具体使用案例如下:
local code = Player:openBoxByPos(objid, x, y, z)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# forceOpenBoxUI

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家强制打开UI界面
  • 具体使用案例如下:
local code = Player:forceOpenBoxUI(objid, itemid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# openDevGoodsBuyDialog

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开开发者商店商品购买弹框
  • 具体使用案例如下:
local code = Player:openDevGoodsBuyDialog(objid, devGoodsId, customDesc)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# openUIView

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开一个UI界面
  • 具体使用案例如下:
local code = Player:openUIView(objid, uiname, param)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# hideUIView

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 隐藏一个UI界面
  • 具体使用案例如下:
local code = Player:hideUIView(objid, uiname)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# changPlayerMoveType

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 改变玩家移动方式
  • 具体使用案例如下:
local code = Player:changPlayerMoveType(objid, moveType)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# shakeCamera

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 抖动玩家镜头
  • 具体使用案例如下:
local code = Player:shakeCamera(objid, duration, power)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# stopShakeCamera

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 停止抖动玩家镜头
  • 具体使用案例如下:
local code = Player:stopShakeCamera(objid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# playQQMusic

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家播放qq音乐
  • 具体使用案例如下:
local code = Player:playQQMusic(playerid, musicId, volume, isLoop)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# operateQQMusic

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 暂停/恢复/停止玩家的QQ音乐
  • 具体使用案例如下:
local code = Player:operateQQMusic(operate, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# OpenAppraiseView

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开评价界面
  • 具体使用案例如下:
local code = Player:OpenAppraiseView(playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# OpenCollectionView

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开收藏界面
  • 具体使用案例如下:
local code = Player:OpenCollectionView(playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# IsMiniVip

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 判断玩家是否是迷你会员(阻塞接口)
  • 具体使用案例如下:
local code = Player:IsMiniVip(playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# SendFriendApply

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 发送好友申请(相同玩家请求间隔必须大于10s)
  • 具体使用案例如下:
local code = Player:SendFriendApply(playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# HasFriend

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 判断两个玩家是否是迷你会员(阻塞接口)
  • 具体使用案例如下:
local code = Player:HasFriend(playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# PlayActInHand

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 玩家手持微缩模型道具播放动作
  • 具体使用案例如下:
local code = Player:PlayActInHand(playerid, animid, playmode)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# OpenBuiltinRank

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 打开内置排行榜
  • 具体使用案例如下:
local code = Player:OpenBuiltinRank(playerid, id)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# HideBuiltinRank

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 隐藏内置排行榜
  • 具体使用案例如下:
local code = Player:HideBuiltinRank(playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end
上次更新: 2023/5/10 15:09:30