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 để thực hiện việc khám phá thiết bị và tạo 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. Hãy xem danh mục GCKDeviceProvider(Protected) để biết danh sách các phương thức trợ giúp dành cho các lớp con. Các trình cung cấp thiết bị mới được đăng ký với khung bằng cách sử dụng registerDeviceProvider: (GCKCastContext).

Năm thành lập
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. Tuỳ chọn khác...
 
(void) - startDiscovery
 Bắt đầu một quy trình quét phát hiện mới. Tuỳ chọn khác...
 
(void) - stopDiscovery
 Dừng quá trình quét để khám phá. Tuỳ chọn khác...
 
(GCKSession *) - createSessionForDevice:sessionID:
 Tạo một phiên mới cho thiết bị đã cho và mã nhận dạng phiên hiện có (không bắt buộc). Tuỳ chọn khác...
 
(void) - notifyDidStartDiscovery
 Thông báo cho trình quản lý khám phá rằng quá trình khám phá đã bắt đầu. Tuỳ chọn khác...
 
(void) - notifyDidPublishDevice:
 Thông báo cho trình quản lý khám phá rằng một thiết bị mới đã được xuất bản. Tuỳ chọn khác...
 
(void) - notifyDidUnpublishDevice:
 Thông báo cho trình quản lý khám phá rằng một thiết bị đã xuất bản trước đó đã bị huỷ xuất bản vì không còn hoạt động nữa. Tuỳ chọn khác...
 
(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 thân thiện hoặc biểu tượng) đã thay đổi. Tuỳ chọn khác...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 Phương thức nhà máy để tạo các thực thể GCKDevice mới. Tuỳ chọn khác...
 

Tóm tắt về tài sản

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. Tuỳ chọn khác...
 
BOOL passiveScan
 Liệu quá trình quét có nên là một quá trình quét thụ động hay không. Tuỳ chọn khác...
 
NSArray< GCKDevice * > * devices
 Mảng thiết bị đã phát hiện. Tuỳ chọn khác...
 

Thông tin chi tiết về phương thức

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

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

Tạo một GCKDeviceProvider mới cho các thiết bị thuộc loại được 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 quy trình quét phát hiện mới.

Đây (thường) là một thao tác không đồng bộ. Nếu bất kỳ thiết bị nào được phát hiện trong lần quét trước không còn hợp lệ, thì nhà cung cấp nên huỷ xuất bản các thiết bị đó tại thời điểm này. Phải được các 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ũ đều đã bị huỷ xuất bản) bằng cách gọi notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Nếu một cách triển khai cụ thể của phương thức này không có công việc không đồng bộ nào cần thực hiện 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 thông báo trước khi trả về.

- (void) stopDiscovery

Dừng quá trình quét để khám phá.

Phải được các 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ã nhận dạng phiên hiện có (không bắt buộc).

Phải được các 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 trình quản lý khám phá rằng quá trình khám phá đã bắt đầu.

Do danh mục GCKDeviceProvider(Protected) cung cấp.

- (void) notifyDidPublishDevice: (GCKDevice *)  device

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

Do danh mục GCKDeviceProvider(Protected) cung cấp.

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Thông báo cho trình quản lý khám phá rằng một thiết bị đã xuất bản trước đó đã bị huỷ xuất bản vì không còn hoạt động nữa.

Do danh mục GCKDeviceProvider(Protected) cung cấp.

- (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 thân thiện hoặc biểu tượng) đã thay đổi.

Do danh mục GCKDeviceProvider(Protected) cung cấp.

- (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 một 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.

Do danh mục GCKDeviceProvider(Protected) cung cấp.

Thông tin chi tiết về cơ sở lưu trú

- (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.

- (BOOL) passiveScan
readwritenonatomicassign

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

Quá trình quét thụ động gửi truy vấn khám phá ít thường xuyên hơn, vì vậy, quá trình này hiệu quả hơn nhưng kết quả sẽ không mới bằng. Bạn nên thực hiệ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 tuân theo thuộc tính này.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

Mảng thiết bị đã phát hiện.