Lớp GCKDeviceProvider

Tài liệu tham khảo về lớp GCKDeviceProvider

Tổng quan

Một lớp cơ sở trừu tượng để khám phá thiết bị và xây dựng phiên.

Bạn có thể thêm tính năng hỗ trợ cho các loại thiết bị khác bằng cách mở rộng lớp này. Xem danh mục GCKDeviceProvider(Protected) để biết danh sách các phương thức trợ giúp dành cho lớp con sử dụng. Các nhà cung cấp thiết bị mới được đăng ký với khung này bằng registerDeviceProvider: (GCKCastContext).

Since
3.0

Kế thừa NSObject.

Tóm tắt phương thức của thực thể

(instancetype) - initWithDeviceCategory:
 Trình khởi tạo được chỉ định. Thêm...
 
(void) - startDiscovery
 Bắt đầu một bản khám phá mới. Thêm...
 
(void) - stopDiscovery
 Dừng quét khám phá. Thêm...
 
(GCKSession *) - createSessionForDevice:sessionID:
 Tạo một phiên mới cho thiết bị đã cho và một mã phiên hiện có (không bắt buộc). Thêm...
 
(void) - notifyDidStartDiscovery
 Thông báo cho người quản lý khám phá rằng quá trình khám phá đã bắt đầu. Thêm...
 
(void) - notifyDidPublishDevice:
 Thông báo cho trình quản lý khám phá rằng đã xuất bản thiết bị mới. Thêm...
 
(void) - notifyDidUnpublishDevice:
 Thông báo cho người quản lý khám phá rằng một thiết bị được xuất bản trước đó đã bị hủy xuất bản vì thiết bị này không còn hoạt động nữa. Thêm...
 
(void) - notifyDidUpdateDevice:
 Thông báo cho trình quản lý khám phá rằng một hoặc nhiều thuộc tính hiển thị của thiết bị đã xuất bản trước đó (chẳng hạn như tên hoặc biểu tượng thân thiện) đã thay đổi. Thêm...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 Phương thức nhà máy để tạo các thực thể GCKDevice mới. Thêm...
 

Tóm tắt thuộc tính

NSString * deviceCategory
 Một chuỗi xác định duy nhất loại thiết bị mà nhà cung cấp này sẽ phát hiện ra. Thêm...
 
BOOL passiveScan
 Liệu quá trình quét có phải là một quá trình quét thụ động hay không. Thêm...
 
NSArray< GCKDevice * > * devices
 Dãy thiết bị được phát hiện. Thêm...
 

Chi tiết phương thức

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

Trình khởi tạo được chỉ định.

Xây dựng một GCKDeviceProvider mới cho các thiết bị thuộc loại đã chỉ định.

Parameters
deviceCategoryA string that uniquely identifies the type of device that is managed by by this provider.
- (void) startDiscovery

Bắt đầu một bản khám phá mới.

Đây (thường là) một phép toán không đồng bộ. Nếu bất kỳ thiết bị nào trong lần quét trước đó phát hiện không còn hợp lệ, thì nhà cung cấp nên hủy xuất bản các thiết bị đó vào thời điểm này. Phải bị lớp con ghi đè.

Nhà cung cấp phải thông báo cho trình quản lý khám phá sau khi quá trình quét bắt đầu (và mọi thiết bị cũ đã bị hủy xuất bản) bằng cách gọi notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Nếu cách triển khai cụ thể của phương thức này không thực hiện được tác vụ không đồng bộ khi bắt đầu quét, thì phương thức này có thể gọi trực tiếp phương thức này trước khi quay lại.

- (void) stopDiscovery

Dừng quét khám phá.

Phải bị lớp con ghi đè.

- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID 

Tạo một phiên mới cho thiết bị đã cho và một mã phiên hiện có (không bắt buộc).

Phải bị lớp con ghi đè.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
- (void) notifyDidStartDiscovery

Thông báo cho người quản lý khám phá rằng quá trình khám phá đã bắt đầu.

Được cung cấp theo danh mục GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

Thông báo cho trình quản lý khám phá rằng đã xuất bản thiết bị mới.

Được cung cấp theo danh mục GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Thông báo cho người quản lý khám phá rằng một thiết bị được xuất bản trước đó đã bị hủy xuất bản vì thiết bị này không còn hoạt động nữa.

Được cung cấp theo danh mục GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Thông báo cho trình quản lý khám phá rằng một hoặc nhiều thuộc tính hiển thị của thiết bị đã xuất bản trước đó (chẳng hạn như tên hoặc biểu tượng thân thiện) đã thay đổi.

Được cung cấp theo danh mục GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 

Phương thức nhà máy để tạo các thực thể GCKDevice mới.

Các tham số tương ứng với các thuộc tính không thể thay đổi của GCKDevice.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddressThe IP address of the device, in numeric form (for example, @"10.0.0.10"). May not be nil.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

Được cung cấp theo danh mục GCKDeviceProvider(Protected).

Chi tiết thuộc tính

- (NSString*) deviceCategory
readnonatomiccopy

Một chuỗi xác định duy nhất loại thiết bị mà nhà cung cấp này sẽ phát hiện ra.

- (BOOL) passiveScan
readwritenonatomicassign

Liệu quá trình quét có phải là một quá trình quét thụ động hay không.

Việc quét thụ động sẽ gửi các truy vấn khám phá ít thường xuyên hơn, nên sẽ hiệu quả hơn, nhưng kết quả sẽ không mới như trước. Bạn nên quét thụ động khi người dùng không chủ động chọn mục tiêu Truyền. Không phải cách triển khai nào cũng phù hợp với thuộc tính này.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

Dãy thiết bị được phát hiện.