用法示例
以下示例重点介绍了开发者如何在内容中使用 VIVEPORT Arcade 计次型(Session)API。
在尝试实现任何 API 函数之前,请确保您的内容具有 VIVEPORT ID 和密钥。
重要:
您将需要第三方服务器身份验证的证书和配置,例如在多玩家或网络中使用自己的服务器。有关详细信息,请参阅
第三方服务器身份验证
。
-
使用
Viveport.Api.Init调用最高级别的 API 以初始化 VIVEPORT SDK。对于 Unity 开发者,通常调用 MonobehaviorStart()。 -
Viveport.Api.Init完成后,调用Session.IsReady()以初始化 Arcade 计次型(Session)API。对于街机环境,强烈建议在内容启动后立即调用此函数。 -
调用
Start()以开始回合。回合开始后,listener.OnStartSuccess()将获取string pchAppID形式的app ID和唯一的回合 GUIDstring pchGuid。可在玩家选择角色或配置加载项后调用此函数。 -
调用
Stop()以结束回合。回合结束后,listener.OnStopSuccess()将获取string pchAppID形式的app ID和与listener.OnStartSuccess()获取的相匹配的唯一的回合 GUIDstring pchGuid。可在玩家完成一款游戏后调用此函数,也可以在“三局两胜”或类似设置结束时调用。 -
不再需要时,请调用
Viveport.Api.Shutdown以释放 VIVEPORT SDK 资源。在 Unity 中,通常是在 MonoBehaviorOnDestroy()中或在Application.Quit()之前。
重要:
请务必在内容启动时调用
Session.IsReady()
,并在适当时间调用
Start()
和
Stop()
以避免收入损失。