GCKDevice Class
Stay organized with collections
Save and categorize content based on your preferences.
outlined_flag
GCKDevice is an object that represents a receiver device and inherits from NSObject, NSCopying, and NSSecureCoding.
The class includes instance methods for comparing devices, checking capabilities, and managing arbitrary attributes.
There is a class method to extract the device category from a unique ID.
Key properties of GCKDevice include network address, service port, unique ID, friendly name, model name, icons, status, and type.
An object representing a receiver device.
Inherits NSObject, <NSCopying>, and <NSSecureCoding>.
- (BOOL) isSameDeviceAs:
(const GCKDevice *)
other
Tests if this device refers to the same physical device as another.
Returns YES if both GCKDevice objects have the same category, device ID, IP address, service port, and protocol version.
- (BOOL) hasCapabilities:
(GCKDeviceCapabilities)
deviceCapabilities
Returns YES if the device supports all of the given capabilities.
Parameters
deviceCapabilities A bitwise-OR of one or more of the GCKDeviceCapabilities constants.
- (void) setAttribute:
(NSObject< NSSecureCoding > *)
attribute
forKey:
(NSString *)
key
Sets an arbitrary attribute in the object.
May be used by custom device providers to store device-specific information for non-Cast devices.
Parameters
attribute The attribute value, which must be key-value coding compliant, and cannot be nil. key The key that identifies the attribute. The key is an arbitrary string. It cannot be nil.
- (nullable NSObject<NSSecureCoding> *) attributeForKey:
(NSString *)
key
Looks up an attribute in the object.
Parameters
key The key that identifies the attribute. The key is an arbitrary string. It cannot be nil.
Returns The value of the attribute, or nil if no such attribute exists.
- (void) removeAttributeForKey:
(NSString *)
key
Removes an attribute from the object.
Parameters
key The key that identifies the attribute. The key is an arbitrary string. It cannot be nil.
- (void) removeAllAttributes
Removes all attributes from the object.
+ (NSString *) deviceCategoryForDeviceUniqueID:
(NSString *)
deviceUniqueID
Extracts the device category from a device unique ID.
Deprecated: Use networkAddress The device's IPv4 address, in dot-notation. Used when making network requests. This will be an empty string for GCKDevice objects that are created with an IPv6 address.
The device's IP address.
Used when making network requests.
Since 4.2
The device's service port.
A unique identifier for the device.
- (NSString*) friendlyName
read write nonatomic copy
The device's friendly name.
This is a user-assignable name such as "Living Room".
An array of GCKImage objects containing icons for the device.
- (GCKDeviceStatus) status
read write nonatomic assign
The device's status at the time that it was most recently scanned.
The status text reported by the currently running receiver application, if any.
- (NSString*) deviceVersion
read write nonatomic copy
The device's protocol version.
- (BOOL) isOnLocalNetwork
read nonatomic assign
YES if this device is on the local network.
The device type.
Since 3.3
The device category, a string that uniquely identifies the type of device.
Cast devices have a category of kGCKCastDeviceCategory .
A globally unique ID for this device.
This is a concatenation of the category and deviceID properties.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[],["The GCKDevice class represents a receiver device, inheriting from NSObject. Key actions include: checking if a device is the same as another (`isSameDeviceAs:`), verifying device capabilities (`hasCapabilities:`), setting, retrieving, and removing attributes (`setAttribute:forKey:`, `attributeForKey:`, `removeAttributeForKey:`, `removeAllAttributes`), and extracting device category from a unique ID (`deviceCategoryForDeviceUniqueID:`). The class also exposes properties like `ipAddress`, `networkAddress`, `servicePort`, `deviceID`, `friendlyName`, `modelName`, `icons`, `status`, `statusText`, `deviceVersion`, `isOnLocalNetwork`, `type`, `category`, and `uniqueID` for device identification and management.\n"]]
