| 継承元 | OTPublisherKit : NSObject |
| 宣言された場所 | OTPublisher.h |
概要
パブリッシャーは、デバイスのマイクと カメラからオーディオ・ビデオストリームを取得します。その後、 以下の [OTSession publish:error:] というメッセージを送った。
OpenTok iOS SDK は、すべてのマルチコア iOS デバイスでの配信に対応しています。 詳細については、README ファイルの「開発者およびクライアントの要件」を参照してください。 OpenTok iOS SDK.
なお、iOSシミュレータでテストを行う場合、シミュレータではカメラが利用できないため、OTPublisherオブジェクトは デモ動画を使用することに注意してください。
パブリッシャーの初期化
– initWithDelegate:settings:
パブリッシャーを、によって定義された設定で初期化します。 OTPublisherSettings オブジェクトがある。
- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate settings:(nonnull OTPublisherSettings *)settings
パラメータ
delegate |
代表（OTPublisherKitDelegate) パブリッシャー用のオブジェクト。 |
settings |
（OTPublisherSettings) パブリッシャーの設定を定義するオブジェクト。 |
登録地
OTPublisher.h
– initWithDelegate:name:cameraResolution:cameraFrameRate:
Publisher オブジェクトを初期化します。
- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate name:(nullable NSString *)name cameraResolution:(OTCameraCaptureResolution)cameraResolution cameraFrameRate:(OTCameraCaptureFrameRate)cameraFrameRate
パラメータ
delegate |
代表（OTPublisherKitDelegate) パブリッシャー用のオブジェクト。 |
name |
動画の下部に表示される名前。 |
cameraResolution |
公開された動画の解像度。これを、 OTCameraCaptureResolution を列挙する。 |
cameraFrameRate |
公開された動画のフレームレート。これを、 OTCameraCaptureFrameRate enum。デバイスが指定されたフレームレートをサポートしていない場合、フレームレートは毎秒30フレームに設定されます。なお、OpenTok Media Router を使用するセッション（ メディアモード （ルーティングに設定されている場合）、フレームレートを下げると、ストリームが使用する帯域幅もそれに比例して減少します。ただし、メディアモードが「中継」に設定されているセッションでは、フレームレートを下げてもストリームの帯域幅は減少しません。 |
戻り値
そのインスタンスへのポインタ、あるいは nil 初期化に失敗した場合。
考察
この方法は非推奨です。代わりに [OTPublisher initWithDelegate:settings:] その代わりだ。
このメソッドには、パブリッシャーの動画の解像度とフレームレートを設定するためのパラメータが含まれています。 から継承された初期化メソッドを使用する場合は、 OTPublisherKit, 解像度はVGAとなり、フレームレートは毎秒30フレームとなります。
以下を使用するセッションについては OpenTok Media Router （メディアモードが「ルーティング」に設定されているセッションでは）、フレーム レートや解像度を下げると、ストリームが使用できる最大帯域幅が 減少します。ただし、メディアモードが「中継」に設定されているセッションでは、 フレームレートや解像度を下げても、ストリームの帯域幅は減少しない場合があります。
登録地
OTPublisher.h
動画の再生
view
このパブリッシャー用のビューです。このビューが表示されると、 アクティブなカメラ映像のプレビューが表示されます。
@property (readonly) UIView *view
登録地
OTPublisher.h
viewScaleBehavior
によって定義される、レンダリングされた動画のスケーリングは、 OTVideoViewScaleBehavior enum。デフォルト値は OTVideoViewScaleBehaviorFill です。動画を必要に応じて縮小し、動画全体が （ピラーボックス表示で）表示されるようにするには、このプロパティを OTVideoViewScaleBehaviorFit に 設定してください。このプロパティは、ローカルパブリッシャーの 動画にのみ影響します。 ストリームのサブスクライバーは、 [OTSubscriber viewScaleBehavior] 財産である。
@property (nonatomic) OTVideoViewScaleBehavior viewScaleBehavior
登録地
OTPublisher.h
パブリッシャーデバイスの設定
cameraPosition
優先カメラ位置。このプロパティを設定すると、変更が 可能な場合、パブリッシャーは指定された位置のカメラを使用します。 パブリッシャーが配信を開始している場合、このプロパティを取得すると現在の カメラ位置が返されます。パブリッシャーがまだ配信を開始していない場合、 このプロパティを取得すると優先カメラ位置が返されます。
@property (nonatomic) AVCaptureDevicePosition cameraPosition
登録地
OTPublisher.h
cameraTorch
カメラの推奨フラッシュライト（懐中電灯）モード。このプロパティを「YES」または「NO」に設定することで、 利用可能な場合、パブリッシャーがカメラのフラッシュライトを有効にするか無効にするかを 指定します。 これは設定値であり、 アクティブなカメラがフラッシュライト機能をサポートしていない場合（例えば、フロント カメラは通常フラッシュライトをサポートしていません）、 反映されない場合があることに注意してください。 パブリッシャーカメラが 有効になっている場合、このプロパティを取得すると現在のフラッシュライトモードが返されます。 パブリッシャーカメラが無効になっている場合、このプロパティを取得すると優先される フラッシュライトモードが返されます。
@property (nonatomic) BOOL cameraTorch
登録地
OTPublisher.h
cameraZoomFactor
カメラの推奨ズーム倍率（比率）。 値が 1.0 の場合はズームなし（デフォルトの表示）を表します。値の範囲は 0.5 から最大ズーム倍率までです。0.5 から 1.0 までの値は 超広角（ズームアウト）を表し、1.0 から 最大ズーム倍率までの値はズームインを表します。 実際に適用されるズーム倍率は、 アクティブなカメラの設定でサポートされている範囲内に 自動的に制限されます。カメラが 超広角をサポートしていない場合、1.0未満に設定されたズーム倍率は 有効にならず、ズームは適用されません。 カメラがサポートする最大ズーム倍率を超える値の場合、 ズーム倍率は最大値に設定されます。パブリッシャー カメラが有効になっている場合、このプロパティを取得すると現在のズーム倍率が返されます。 パブリッシャーカメラが無効になっている場合、このプロパティを取得すると 推奨ズーム倍率が返されます。
@property (nonatomic) float cameraZoomFactor
登録地
OTPublisher.h