通过

PFMultiplayerInitialize

  • 项目

初始化 PlayFab 多人游戏库的实例。

语法

HRESULT PFMultiplayerInitialize(  
    const char* playFabTitleId,  
    PFMultiplayerHandle* handle  
)

参数

playFabTitleId char*
以 null 结尾

应用的 PlayFab 游戏 ID。

handle PFMultiplayerHandle*
库分配的输出

新初始化的 PFMultiplayer API 实例的输出句柄。

返回值

类型：HRESULT

如果调用成功，则为 S_OK，否则为错误代码。 可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。

备注

除了 PFMultiplayerSetMemoryCallbacks() 和 PFMultiplayerSetThreadAffinityMask()，必须在任何其他方法之前调用此方法。 在没有后续 PFMultiplayerUninitialize() 调用的情况下，无法再次调用 PFMultiplayerInitialize()。

每次调用 PFMultiplayerInitialize() 都应该调用相应的 PFMultiplayerUninitialize()。

使用多人游戏库的 Microsoft Game Core 版本的应用需要等待 Game Core 网络堆栈初始化，然后再调用此方法。 可以使用 Game Core XNetworkingGetConnectivityHint API 来确定网络堆栈的状态。

提供的 playFabTitleId 必须是用于获取将传递给 PFMultiplayerSetEntityToken() 的 PlayFab 实体密钥和实体令牌的同一 PlayFab 游戏 ID。

要求

标头: PFMultiplayer.h

另请参阅

PFMultiplayer 成员
PFMultiplayerSetEntityToken
PFMultiplayerUninitialize
PFMultiplayerSetMemoryCallbacks
PFMultiplayerSetThreadAffinityMask