大厅属性

本文介绍大厅中存储的自定义属性。 使用此功能可存储大厅所表示的游戏会话的相关元数据。

预定义属性

每个大厅都有一组预定义的属性,通常用于大多数游戏场景。

属性 定义
lobbyId 这是大厅的唯一标识符。 它可用于区分玩家可能所属的多个大厅。
connectionString 用于加入大厅的标识符。 它由大厅服务提供。 向其他玩家发送邀请时,connectionString 将作为邀请发送。
maxMemberCount 大厅中允许的最大玩家数。 此属性只能由所有者更改。
owner 拥有大厅的实体。 在某些情况下,一些大厅可能暂时没有所有者。 若要了解详细信息,请参阅所有权更改
ownerMigrationPolicy 策略确定如何选择新所有者。 若要了解详细信息,请参阅所有权更改
accessPolicy 策略指示可以发现大厅的连接字符串的人员。 此属性只能由所有者更改。
membershipLock 此值指示新成员是否可以加入大厅。 锁定后,新成员可能无法加入。 解锁后,新成员可以加入。 此属性只能由所有者更改。

自定义属性

游戏可以定义 3 种类型的自定义属性。

  1. 自定义大厅属性
    • 这些属性适用于整个大厅。
    • 只有大厅的成员才能看到这些属性。
    • 只有大厅的所有者才能更改这些属性。
  2. 自定义成员属性
    • 大厅中每个成员都有成员属性的唯一映射
    • 只有大厅的成员才能看到这些属性。
    • 大厅的所有成员都可以看到其他每个成员的属性。
    • 每个成员都可以修改自己的成员属性,但不能修改另一个成员的属性。
    • 成员离开大厅后,将从大厅中删除其成员属性。
  3. 自定义搜索属性。
    • 这些是特殊属性,游戏中的所有玩家都可以使用这些属性来搜索符合特定条件的大厅。
    • 这些属性适用于整个大厅。
    • 只有大厅的所有者才能更改这些属性。
    • 对于可用于这些属性的键,存在一些限制。
    • 若要了解详细信息,请参阅创建可搜索大厅

所有属性都是键-值对的映射。

另请参阅