概要
キャスト センダーとキャスト レシーバー間でメッセージを交換するための仮想通信チャネル。
各チャネルには固有の名前空間がタグ付けされるため、センダーとレシーバー間の単一のネットワーク接続を介して複数のチャネルが多重化される場合があります。
チャンネルを使用するには、GCKCastSession で登録する必要があります。関連付けられたセッションが確立されると、チャンネルが自動的に接続され、メッセージを送受信できるようになります。
サブクラスでは、受信メッセージを処理するために didReceiveTextMessage: (GCKCastChannel) メソッドを実装する必要があります。通常は、特定の名前空間に固有のメッセージを送信するための追加のメソッドを提供します。
NSObject を継承します。
GCKGameManagerChannel、GCKGenericChannel、GCKMediaControlChannel によって継承されます。
インスタンス メソッドの概要 | |
(instancetype) | - initWithNamespace: |
指定のイニシャライザ。その他... | |
(instancetype) | - init |
デフォルトのイニシャライザは使用できません。その他... | |
(void) | - didReceiveTextMessage: |
このチャンネルでテキスト メッセージを受信したときに呼び出されます。その他... | |
(BOOL) | - sendTextMessage: |
このチャンネルでテキスト メッセージを送信します。その他... | |
(BOOL) | - sendTextMessage:error: |
このチャンネルでテキスト メッセージを送信します。その他... | |
(NSInteger) | - generateRequestID |
新しいメッセージのリクエスト ID を生成します。その他... | |
(NSNumber *__nullable) | - generateRequestNumber |
generateRequestID の結果を NSNumber でラップする便利なメソッド。その他... | |
(void) | - didConnect |
このチャンネルが接続されたときに呼び出され、このチャンネル経由でキャスト デバイスとメッセージを交換できるようになったことを示します。その他... | |
(void) | - didDisconnect |
このチャンネルの接続が解除されたときに呼び出されます。これは、このチャンネル経由でキャスト デバイスとメッセージを交換できないことを表します。その他... | |
プロパティの概要 | |
NSString * | protocolNamespace |
チャンネルの名前空間。その他... | |
BOOL | isConnected |
このチャンネルが現在接続されているかどうかを示すフラグ。その他... | |
GCKDeviceManager * | deviceManager |
このチャンネルが登録されているデバイス マネージャー(存在する場合)。その他... | |
メソッドの詳細
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
指定のイニシャライザ。
指定された Namespace で新しい GCKCastChannel を作成します。
- Parameters
-
protocolNamespace The namespace.
GCKGenericChannel に実装されました。
- (instancetype) init |
デフォルトのイニシャライザは使用できません。
GCKMediaControlChannel と GCKGameManagerChannel に実装されました。
- (void) didReceiveTextMessage: | (NSString *) | message |
このチャンネルでテキスト メッセージを受信したときに呼び出されます。
デフォルトの実装では何も起こりません。
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
このチャンネルでテキスト メッセージを送信します。
- Parameters
-
message The message.
- 戻り値
- 成功の場合は
YES
、メッセージを送信できなかった場合(チャネルが接続されていないか、送信バッファが現時点でいっぱいになっているため)はNO
。
- Deprecated:
- sendTextMessage:error: を使用して、詳細なエラー情報を提供します。
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
このチャンネルでテキスト メッセージを送信します。
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- 戻り値
YES
(成功した場合はYES
、メッセージを送信できなかった場合はNO
)。
- (NSInteger) generateRequestID |
新しいメッセージのリクエスト ID を生成します。
- 戻り値
- 生成された ID、またはチャンネルが現在接続されていない場合は kGCKInvalidRequestID。
- (NSNumber * __nullable) generateRequestNumber |
generateRequestID の結果を NSNumber でラップする便利なメソッド。
- 戻り値
- 生成された ID、またはチャンネルが現在接続されていない場合は
nil
。
- (void) didConnect |
このチャンネルが接続されたときに呼び出され、このチャンネル経由でキャスト デバイスとメッセージを交換できるようになったことを示します。
デフォルトの実装では何も起こりません。
- (void) didDisconnect |
このチャンネルの接続が解除されたときに呼び出されます。これは、このチャンネル経由でキャスト デバイスとメッセージを交換できないことを表します。
デフォルトの実装では何も起こりません。
物件の詳細
|
readnonatomiccopy |
チャンネルの名前空間。
|
readnonatomicassign |
このチャンネルが現在接続されているかどうかを示すフラグ。
|
readnonatomicweak |
このチャンネルが登録されているデバイス マネージャー(存在する場合)。
- Deprecated:
- 非推奨の GCKDeviceManager クラスにこのチャンネルが登録されていない場合は、
nil
になります。