XblPresenceRichPresenceIds

需要设置丰富状态的 ID。

语法

typedef struct XblPresenceRichPresenceIds {  
    char scid[XBL_SCID_LENGTH];  
    const char* presenceId;  
    const char** presenceTokenIds;  
    size_t presenceTokenIdsCount;  
} XblPresenceRichPresenceIds  

成员

scid
类型:char[XBL_SCID_LENGTH]

包含状态字符串的服务配置的 ID。

presenceId
类型:const char*

在服务配置中定义的状态字符串的 ID。 例如,在服务配置中,PresenceId =“1”可相当于“正在 {1} 上玩 {0}”。 服务配置可以将令牌 0 映射到“地图”,将令牌 1 映射到 MapId。

presenceTokenIds
类型:const char**

用于替换在状态字符串中找到的格式字符串令牌的字符串的 ID。 这些字符串也在服务配置中定义。 集合中的 ID 值映射到在 PresenceId 中找到的令牌参数所关联的字符串。 例如,假设此向量视图包含值“4”和“1”,而在服务配置中 PresenceId =“1”等价于“正在 {1} 上玩 {0}”。 服务配置可以将令牌 0 映射到“地图”,其中的 MapId =“4”等价于“家乡”。 服务配置可以映射令牌 1 =“难度”,其中的 DifficultyId =“1”等价于“休闲”。

presenceTokenIdsCount
类型:size_t

presenceTokenIds 数组中的 ID 数量。

参数属于

XblPresenceSetPresenceAsync

要求

头文件:presence_c.h

另请参阅

presence_c