v1.0.0
Latest
2022.3+

Class DataObject

Custom data property for a lobby.

Inheritance
System.Object
DataObject
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Unity.Services.Lobbies.Models
Syntax
public class DataObject

Constructors

DataObject(DataObject.VisibilityOptions, String, DataObject.IndexOptions)

Custom data property for a lobby.

Declaration
public DataObject(DataObject.VisibilityOptions visibility, string value = null, DataObject.IndexOptions index = (DataObject.IndexOptions)0)
Parameters
TypeNameDescription
DataObject.VisibilityOptionsvisibility

Indicates for whom the property should be visible. If public, the property will be visible to everyone and will be included in query results. If member, the data will only be visible to users who are members of the lobby (i.e. those who have successfully joined). If private, the metadata will only be visible to the host.

System.Stringvalue

The value of the custom property. This property can be set to null or an empty string. If this property is indexed (by setting the index field) then the length of the value must be less than 128 bytes.

DataObject.IndexOptionsindex

The name of the column to index this property value under, either S# for strings or N# for numeric values. If an index is specified on a property, then you can use that index name in a QueryFilter to filter results by that property. You will not be prevented from indexing multiple objects having properties with different names but the same index, but you will likely receive unexpected results from a query.

Properties

Index

The name of the column to index this property value under, either S# for strings or N# for numeric values. If an index is specified on a property, then you can use that index name in a QueryFilter to filter results by that property. You will not be prevented from indexing multiple objects having properties with different names but the same index, but you will likely receive unexpected results from a query.

Declaration
public DataObject.IndexOptions Index { get; }
Property Value
TypeDescription
DataObject.IndexOptions

Value

The value of the custom property. This property can be set to null or an empty string. If this property is indexed (by setting the index field) then the length of the value must be less than 128 bytes.

Declaration
public string Value { get; }
Property Value
TypeDescription
System.String

Visibility

Indicates for whom the property should be visible. If public, the property will be visible to everyone and will be included in query results. If member, the data will only be visible to users who are members of the lobby (i.e. those who have successfully joined). If private, the metadata will only be visible to the host.

Declaration
public DataObject.VisibilityOptions Visibility { get; }
Property Value
TypeDescription
DataObject.VisibilityOptions