【027废弃】游戏跳游戏

喵喵哭唧唧 · 发表于 2023-2-21 13:48:05

本帖最后由哭唧唧的细狗于 2023-10-26 16:08 编辑

在游戏中，可能存在这样的需求，我制作了两个游戏（或者朋友制作的一个游戏），希望能在游戏中通过某个方式，实现游戏A的角色能够携带它的外貌，装备，血量等等，进入游戏B与该游戏的用户一起游玩体验

超简单，我一通操作就跳转游戏了

废话少数，先上效果

如视频中的效果，我们从基础Demo跳转到了最近大火的“只因哥大战小黑子”游戏里

上图中左侧红框里的按钮就是跳转游戏按钮，直接点击就会进行跳转，因为代码里已经加上了对应的gameID

gameID获取的方式：创作者中心→我的游戏→游戏名下方一个p_开头的就是gameid，点旁边的复制就可以复制过来

跳游戏的话，只会跳往现行的、目前处在上线状态的、过了审的那个版本

A游戏调用跳转接口部分：

这里“谁不是ikun”就是从A游戏想要带到B游戏的数据

// 点击跳ts游戏按钮后，跳转到其他游戏

JumpTsBtn.onClicked.add(()=>{

    // 调用enterNewGame接口，传入gameID来进行跳转，这里“谁不是ikun”就是从A游戏想要带到B游戏的数据

    Service.RouteService.getInstance().enterNewGame(”P_21def1ac9e0a4e73500d90bb2b5d53bfd1d9cf40“,"谁不是ikun");      

})

从A跳转到B游戏后，B游戏接收数据部分(如果不接收数据那就啥都不处理都成)：

Service.RouteService.getInstance().addJumpGameCallback((id: string, data: string)=>{

    // data里包含的就是谁不是ikun

    console.log("66666666666 ", id, data)

})

这里附上最简单的Demo，我们可以通过已知的233游戏的GameID来进行跳转

跨进程带数据.rar (146.91 KB, 下载次数: 42)

2023-4-12 13:28 上传

点击文件名下载附件

跳转游戏常见问题

我能和好友一起跳转游戏吗？

好问题！
跳转游戏可以分为单人跳转和组队跳转，如果想要让玩家能与好友一起跳转游戏，我们只需要调用enterNewGameByTeam接口并告诉服务器这几位用户的plyaerID即可

我跳转游戏后能把跳转前游戏的血量，装备等信息带入新的游戏吗？

特别好的问题！
跳转游戏时无论单人或组队跳转，我们都能在对应接口里传入想要带入下一个游戏的数据，只要跳转的游戏做了相应的处理，我们就能在新的游戏里直接显示应用这些数据，达到多个游戏无缝衔接

游戏里角色穿着的服装有专门的方法可以带入其它游戏中，不用走跳转游戏带数据这么一个流程，将在最后介绍

更细致的知识，如果你想要搞清楚跳转游戏的各种细节

获取游戏ID

游戏ID分为两种：MGSGameID和GameID。MGSGameID是指内容库中游戏ID（233里能搜到的游戏ID，既短ID），GameID是内部游戏的真实ID。两者是1对1的映射关系。MGSGameID暴露在外部，通过MGSGameID可以获取到对应的GameID，反之亦然。游戏跳转使用的是GameID。Service命名空间中的RouteService类（单例类）为我们提供了下述方法帮助我们获取当前游戏这两个ID并相互转换

获取当前游戏的GameID（只在客户端调用生效）

/**

 * @description 获取游戏Id

 * @effect 只在客户端调用生效

 * @precautions 只在由233拉起生效（这里和技术确认过通过跳游戏拉起的游戏也能拿，辛苦测试下）

 * @returns GameId

 */

static getGameId(): string;



// 调用方法如下：

let gameID = Service.RouteService.getGameId();

获取当前游戏的MGSGameID（只在客户端调用生效）

/**

 * @description 获取短游戏ID

 * @effect 只在客户端调用生效

 * @precautions 只在由233拉起生效（这里和技术确认过通过跳游戏拉起的游戏也能拿，辛苦测试下）

 * @returns 短游戏ID

 */

static getMGSGameId(): string;







// 调用方法如下：

let MGSGameID = Service.RouteService.getMGSGameId();

获取当前游戏的GameVersion（游戏版本，只在客户端调用生效）

/**

 * @description 获取游戏版本

 * @effect 只在客户端调用生效

 * @precautions 只在由233拉起生效（这里和技术确认过通过跳游戏拉起的游戏也能拿，辛苦测试下）

 * @returns GameVersion

 */

static getGameVersion(): string;







// 调用方法如下：

let gameVersion = Service.RouteService.getGameVersion();

向服务器请求获取输入的GameID对应的MgsGameID（因为是去ds服务器请求所以需要使用异步）

/**

 * @description 用gameId来换取内容库MGSGameId

 * @effect 调用端生效

 * @param targetGameId usage: 目标游戏的gameId

 * @returns 对应的MGSGameId

 */

requestMGSGameId(targetGameId: string): Promise<string>;







// 调用方法如下：

let gameID = Service.RouteService.getGameId();

let gameVersion = Service.RouteService.getInstance().requestMGSGameId(gameID);

向服务器请求获取输入的MgsGameID对应的GameID（因为是去ds服务器请求所以需要使用异步）

/**

 * @description 用内容库MGSGameId来换取gameId

 * @effect 调用端生效

 * @param targetMgsGameId usage: 目标游戏的内容库gameId

 * @returns 对应的gameId

 */

requestGameId(targetMgsGameId: string): Promise<string>;







// 调用方法如下：

let MGSGameID = Service.RouteService.getMGSGameId();

let gameVersion = Service.RouteService.getInstance().requestGameId(MGSGameID);

跳转游戏

组队跳转流程图：

单人跳转流程图：

跳转接口

当我们获取到游戏ID后就可以调用RouteService类中的跳转接口跳游戏了。一般来说跳转针对外部开发者来说主要是以下两个接口：

单独跳转（客户端调用）
该函数需要一个目标GameID，和需要传递的数据（一般是一个转成string的json）

/**

 * @description 跳转到新游戏，同进程跳转

 * @effect 只在客户端调用生效

 * @param targetGameId usage: 要跳转的目标游戏ID，MWGameId

 * @param carryingData usage: 跳游戏携带的数据 default: undefined

 */

enterNewGame(targetGameId: string, carryingData?: string): void;







// 调用方法如下：

Service.RouteService.getInstance().enterNewGame(gameID, "Make Trump Great Again");

组队跳转（服务端调用）

/**

 * @description 组队跳游戏，可以携带数据

 * @effect 只在服务端调用生效

 * @param targetGameId usage: 要跳转的游戏的mwGameId

 * @param teammatePlayerIds usage: 队友的playerId数组

 * @param carryingData usage: 要带入新游戏的数据 default: undefined

 * @returns 组队跳转请求回调

 */

enterNewGameByTeam(targetGameId: string, teammatePlayerIds: string[], carryingData?: Record<string, unknown>[]): Promise<void>;





// 调用方法如下：

Service.RouteService.getInstance().enterNewGameByTeam(gameID, [20278, 20256], "111");

跳转到广场游戏（如果游戏接入）

/**

 * @description 将当前MW进程恢复小窗，拉起新进程进入广场游戏。与默认的跳游戏模式不同。

 * @effect 只在客户端调用生效

 * @precautions 只在233内使用时生效

 * @param squareMgsGameId usage: 新的广场游戏GameId，如果为空，则使用各环境默认的广场游戏Id default: null

 * @param carryingData usage: 跳游戏携带的数据 default: undefined

 */

enterSquareGame(squareMgsGameId?: string, carryingData?: string): void;

监听跳转结果

当跳转行为完成后，新游戏需要监听跳转行为以对加入的玩家和它们携带的数据进行处理，RouteService类为我们提供了下面四个监听跳转行为和处理数据的接口（这里主要针对单人和组队提供了不同的接口）：

针对单客户端：

监听单人跳转（客户端调用）：

回调中接口传出了来源游戏的GameID和该玩家携带的数据方便开发者第一时间对加入的玩家进行处理

/**

 * @description 注册游戏跳转的回调，当跨进程从其他游戏跳转到当前游戏时触发。可以被动获取来源游戏Id和携带的数据

 * @effect 只在客户端调用生效

 * @param callback usage: 要注册的回调，在接收到跳转信息时触发

 */

addJumpGameCallback(callback: (jumpFromGameId: string, carryingData: string) => void): void;

方法1：通过addJumpGameCallback接口在新游戏中监听单人玩家跳转，并接收跳转前游戏带过来的数据

Service.RouteService.getInstance().addJumpGameCallback((id: string, data: string)=>{

    console.log("66666666666 ", id, data)

})

方法2：客户端上监听玩家加入并通过getGameCarryingData接口获取跳转前游戏带过来的数据

Events.addPlayerJoinedListener((player:Gameplay.Player)=>{

    Service.RouteService.getInstance().getGameCarryingData().then((data)=>{

        console.log("777777777777777777 ", data)

    })

})

获取跳转玩家的来源游戏MGSGameID（客户端调用）：

该接口可以帮助开发者获取跳转玩家来源于哪个游戏

/**

* @description 获取游戏来源信息

* @effect 只在客户端调用生效

* @returns 当前游戏是从哪个游戏跳转过来的，为空则不是游戏跳转

*/

getJumpFromMGSGameId(): Promise<string>;

获取跳转玩家的携带数据（客户端调用）：

该接口可以帮助开发者随时获取跳转玩家加入时携带的数据

/**

 * @description 获取拉起游戏时传入的数据

 * @effect 只在客户端调用生效

 * @precautions 如果是组队跳游戏，请使用getTeamCarryingData在服务端获取数据。

 * @returns 拉起游戏时传入的数据

 */

getGameCarryingData(): Promise<string>;

针对组队：

监听组队跳转（服务端调用）：

组队跳转本质上也是单人跳转，所以会触发单人跳转回调，只是carryingData为空，数据需要你自己在服务器打包后通过enterNewGameByTeam接口中的data去传递。这样才能在onReceiveTeamData里面收到你想要的队伍数据。

委托中传出了队伍ID和该队伍携带的数据方便开发者第一时间对加入的玩家们进行处理。队伍数据是一个Map，键值是玩家ID。

/**

 * @description 收到队伍数据时会触发的委托

 * @networkStatus usage: 服务端

 */

onReceiveTeamData: Type.MulticastDelegate<(teamId: string, data: Record<string, unknown>) => void>;



// 用例：

protected onStart() {

    RouteService.getInstance().onReceiveTeamData.add((teamId: string, data: Record<string, unknown>)=>{

        console.log("teamId", teamId, JSON.stringify(data))

    })

}

监听组队请求结果（服务端调用）：

该委托可以帮助开发者获取此次组队跳转请求是否成功（可能由于队伍人数过多或者网络波动失败），委托会传出失败原因供开发者获取。

/**

 * @description 组队请求失败时会触发的委托

 * @networkStatus usage: 服务端

 */

onTeamMatchFailure: Type.MulticastDelegate<(failureInfo: TeamMatchFailureInfo) => void>;

获取跳转队伍的携带数据（服务端调用）：

该接口可以帮助开发者随时通过队伍ID（Player提供接口去获取玩家的跳转队伍ID）去获取跳转队伍加入时携带的数据。

/**

 * @description 获取指定Team在组队跳转时带入游戏的数据

 * @effect 只在服务端调用生效

 * @param teamId usage: 要查询的teamId

 * @returns 指定队伍的数据

 */

getTeamCarryingData(teamId: string): Record<string, unknown>;

清除指定队伍的数据（服务端调用）：

由于组队数据是在服务器维护，所以提供了一个接口可以提前手动清除（如果该队伍的玩家都不再存在于当前游戏中，内部会自动调用这个接口）。

/**

 * @description 删除指定Team在组队跳转时带入游戏的数据

 * @effect 只在服务端调用生效

 * @param teamId usage: 目标teamId

 */

clearTeamCarryingData(teamId: string): void;

除了组队跳转接口，其余跳转接口调用时会立即退出当前游戏（关闭虚拟机），但是组队跳转多了一个组队步骤，所以调用时游戏并不会退出，而是等获取到跳转结果时在退出，中间存在一个时间差。

跳转失败

跳转到gameid对应的游戏不存在，用户侧将没有变化
自己跳自己（别笑，有可能玩家想要从游戏的A房间跳B房间），用户侧将没有变化
已下线的游戏，跳游戏用户侧将没有变化。可以通过扫码拉起（下线的游戏是会关闭服务器的，但是通过扫码启动游戏服务器后，就又可以跳转了）。
新发布的游戏，未审核的情况下无法跳转（此时还未入内容库，没有gameId）。如果是已发布的游戏，更新但未审核是可以跳转的。

玩家是否跳转加入

在Player类中还提供了一个接口，帮助开发者判断当前玩家是否是通过游戏跳转加入的游戏，如果是那会返回他的跳转队伍ID（如果玩家不是跳转的则返回空）：

/**

 * @description 获取玩家的TeamId

 * @effect  调用端生效

 * @returns 玩家的TeamId，如不在队伍中，则为空

 */

getTeamId(): string;

游戏跳转后保持外形

Service命名空间中新增AccountService类。AccountService类用于提供用户账号信息管理相关服务。AccountService类是单例类，请使用getInstance获取对象。

uploadData(character: Gameplay.CharacterBase, callback?: BoolResponse | VoidResponse, index?: number, openStatus?: number): void

downloadData(character: Gameplay.CharacterBase, callback?: BoolResponse | VoidResponse, index?: number): void

Service.AccountService.getInstance().downloadData 可以下载上传过的槽位的换装资源，index默认是索引为0的主角资源位

该接口的应用场景是所有接入了233账号的地方，都可以把玩家的套装数据上传到服务器，比如广场类游戏改变了形象，然后跳转到其他游戏，这时候下载相关资源就可以，并且通过5个索引位置，可以实现不同游戏加载不同存储的服装类型，比如从广场跳转到哈利波特的魔法世界类型的游戏，和跳转战地战争机器一类的游戏，就可以用不同的存储索引位置来加载不同的服装

使用setAppearance的setMesh方法换衣服，不需要预加载相关服装id

这里我通过默认demo的interact按钮设置了上衣和裤子的模型，并且通过jump按钮上传到了233账号的信息里，atk按钮会下载该信息

protected onStart() {

        //设置能否每帧触发onUpdate

        this.canUpdate = false;



        Gameplay.asyncGetCurrentPlayer().then((player) => {

            this.Character = player.character;

        });



        //找到对应的跳跃按钮

        const JumpBtn = this.uiWidgetBase.findChildByPath('MWCanvas/MWButton_Jump') as UI.StaleButton

        //点击跳跃按钮,异步获取人物后执行跳跃

        JumpBtn.onPressed.add(() => {

            Service.AccountService.getInstance().uploadData(this.Character)

        })



        const atkBtn = this.uiWidgetBase.findChildByPath('MWCanvas/MWButton_Attack') as UI.StaleButton

        atkBtn.onPressed.add(() => {

            Service.AccountService.getInstance().downloadData(this.Character)



            let v2 = this.Character.setAppearance(Gameplay.HumanoidV2)

            console.log(`444444444 upper ${v2.upperCloth.getMesh()} ~ lower ${v2.lowerCloth.getMesh()}`)

        })



        const intBtn = this.uiWidgetBase.findChildByPath('MWCanvas/MWButton_Interact') as UI.StaleButton

        intBtn.onPressed.add(() => {

            let v2 = this.Character.setAppearance(Gameplay.HumanoidV2)

            v2.upperCloth.setMesh("60055", true)

            v2.lowerCloth.setMesh("59855", true)

        })

    }

当上传以后，如果勾选了对象管理器里Player中的使用平台角色形象，那么233上进入游戏后会自动应用账户编辑的数据

可以看到，这里进入游戏自动同步了

如果没有勾选使用平台角色形象，可以看到，进入游戏是默认套装，当我点击了atk按钮后，执行了AccountService的downloadData方法，这时候角色同步了衣服和裤子的信息

【关键字】：游戏跳转，场景切换，切换游戏

唯美傷飛上天 · 发表于 2023-2-28 08:29:55

风清月明 · 发表于 2023-11-19 17:23:56

请问，所以游戏关卡的切换都要以这种方式展开吗？
没有发布阶段怎么做测试啊

哭唧唧的细狗 · 发表于 2023-11-20 09:40:05

风清月明发表于 2023-11-19 17:23
请问，所以游戏关卡的切换都要以这种方式展开吗？
没有发布阶段怎么做测试啊 ...

你好，现阶段做关卡切换推荐在一个地图上摆放多个场景，如果场景过于太大进入游戏太慢，就把场景做成预制体动态加载地图，有玩家在的地图加载，没玩家的地图可以晚点加载

后续会推出游戏内的关切切换功能，届时就可以很容易的制作相关功能了

风清月明 · 发表于 2023-11-20 10:24:40

哭唧唧的细狗发表于 2023-11-20 09:40
你好，现阶段做关卡切换推荐在一个地图上摆放多个场景，如果场景过于太大进入游戏太慢，就把场景做成预制 ...

你好，我教程看完了，都是针对一个直接开始游戏来讲解的。
问题一个房间的玩家是不定的，有些也是纯挂机的，不能一进去就开始游戏（这个目前看到的解决方法就是1个挂机广场，然后同房间几个人一起决定传送到某个某个位置开始游戏【或者有什么别的实现思路】）。
还有如果是1个房间的2个玩家进行匹配一起传送到一个位置开始游戏的话，体验感不太好；
我现在想做的是全服1v1的匹配机制，然后一起跳转关卡(同一个房间玩家数量不够)，这个目前有办法吗？

哭唧唧的细狗 · 发表于 2023-11-20 10:39:50

风清月明发表于 2023-11-20 10:24
你好，我教程看完了，都是针对一个直接开始游戏来讲解的。
问题一个房间的玩家是不定的，有些也是纯挂机 ...

你好，目前是没办法做到一起跳转关卡的，抱歉，应该是下个大版本即028就会推出游戏内的多场景切换了，届时就可以开发轻松和某个房间内的玩家一起跳转到某个地图的功能

风清月明 · 发表于 2023-11-20 11:19:24

哭唧唧的细狗发表于 2023-11-20 10:39
你好，目前是没办法做到一起跳转关卡的，抱歉，应该是下个大版本即028就会推出游戏内的多场景切换了，届 ...

好嘞，谢谢

风清月明 · 发表于 2023-11-23 10:14:42

哭唧唧的细狗发表于 2023-11-20 10:39
你好，目前是没办法做到一起跳转关卡的，抱歉，应该是下个大版本即028就会推出游戏内的多场景切换了，届 ...

你好，028版本的关卡跳转的话，一：每个关卡的服务器脚本默认只会同步给当前关卡的玩家吗？比如我的关卡1中物体在服务端tick移动逻辑造成的物体位移只会同步给关卡1的玩家AB，不会影响到关卡2和3和主关卡的玩家，也不会影响他们的性能？二：每个关卡的tick都是独立的吗？三：主关卡能获取到子关卡中的玩家信息吗？