用法示例
以下示例重点介绍了开发者如何在内容中使用 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()
以避免收入损失。