Übersicht

Ein Publisher erfasst einen Audio-Video-Stream vom Mikrofon und der Kamera des Geräts. Anschließend können Sie den Audio-Video-Stream in einer OpenTok-Sitzung veröffentlichen, indem Sie den [OTSession publish:error:] Nachricht.

Das OpenTok iOS SDK unterstützt die Veröffentlichung auf allen iOS-Geräten mit mehreren Kernen. Weitere Informationen finden Sie unter „Anforderungen an Entwickler und Clients“ in der README-Datei für das OpenTok iOS-SDK.

Beachten Sie, dass bei Tests im iOS-Simulator ein OTPublisher-Objekt ein Demovideo verwendet, da im Simulator keine Kamera zur Verfügung steht.

Initialisierung eines Publishers

– initWithDelegate:settings:

Initialisieren Sie den Publisher mit den Einstellungen, die durch eine OTPublisherEinstellungen Objekt.

- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate settings:(nonnull OTPublisherSettings *)settings

Parameter

Angemeldet in

OTPublisher.h

– initWithDelegate:name:cameraResolution:cameraFrameRate:

Initialisiere ein Publisher-Objekt.

- (nullable instancetype)initWithDelegate:(nullable id<OTPublisherKitDelegate>)delegate name:(nullable NSString *)name cameraResolution:(OTCameraCaptureResolution)cameraResolution cameraFrameRate:(OTCameraCaptureFrameRate)cameraFrameRate

Parameter

Rückgabewert

Der Zeiger auf die Instanz oder nil falls die Initialisierung fehlgeschlagen ist.

Diskussion

Diese Methode ist veraltet. Verwenden Sie stattdessen [OTPublisher initWithDelegate:settings:] stattdessen.

Diese Methode enthält Parameter zur Einstellung der Auflösung und der Bildrate des Videos des Herausgebers. Wenn Sie eine Initialisierungsmethode verwenden, die von OTPublisherKit, die Auflösung beträgt VGA und die Bildrate liegt bei 30 Bildern pro Sekunde.

Für Sitzungen, die der OpenTok Media Router (In Sitzungen, bei denen der Medienmodus auf „geroutet“ eingestellt ist), verringert eine Senkung der Bildrate oder der Auflösung die maximale Bandbreite, die der Stream nutzen kann. In Sitzungen, bei denen der Medienmodus auf „weitergeleitet“ eingestellt ist, führt eine Senkung der Bildrate oder der Auflösung jedoch möglicherweise nicht zu einer Verringerung der Bandbreite des Streams.

Angemeldet in

OTPublisher.h

Das Video anzeigen

view

Die Ansicht für diesen Herausgeber. Wenn diese Ansicht sichtbar wird, wird eine Vorschau des aktiven Kamerabildes angezeigt.

@property (readonly) UIView *view

Angemeldet in

OTPublisher.h

viewScaleBehavior

Die Skalierung des gerenderten Videos, wie durch die OTVideoViewScaleBehavior enum. Der Standardwert lautet OTVideoViewScaleBehaviorFill. Setzen Sie den Wert auf OTVideoViewScaleBehaviorFit, damit das Video bei Bedarf verkleinert wird, sodass das gesamte Video sichtbar ist (mit Pillarboxing). Diese Eigenschaft wirkt sich nur auf das Video des lokalen Herausgebers aus. Abonnenten des Streams müssen die [OTSubscriber viewScaleBehavior] Eigentum.

@property (nonatomic) OTVideoViewScaleBehavior viewScaleBehavior

Angemeldet in

OTPublisher.h

Konfiguration des Publisher-Geräts festlegen

cameraPosition

Die bevorzugte Kameraposition. Wenn diese Eigenschaft festgelegt wird und die Änderung möglich ist, verwendet der Publisher die Kamera mit der angegebenen Position. Wenn der Publisher bereits mit der Veröffentlichung begonnen hat, gibt der Abruf dieser Eigenschaft die aktuelle Kameraposition zurück; wenn der Publisher noch nicht mit der Veröffentlichung begonnen hat, gibt der Abruf dieser Eigenschaft die bevorzugte Kameraposition zurück.

@property (nonatomic) AVCaptureDevicePosition cameraPosition

Angemeldet in

OTPublisher.h

cameraTorch

Der bevorzugte Taschenlampenmodus für die Kamera. Durch Setzen dieser Eigenschaft auf „YES“ oder „NO“ wird festgelegt, ob der Herausgeber die Taschenlampe der Kamera aktivieren oder deaktivieren soll, sofern diese verfügbar ist. Beachten Sie, dass es sich hierbei um eine Einstellung handelt, die möglicherweise nicht wirksam wird, wenn die aktive Kamera die Blitzlichtfunktion nicht unterstützt (beispielsweise unterstützt die Frontkamera in der Regel kein Blitzlicht). Ist die Publisher-Kamera aktiviert, gibt der Abruf dieser Eigenschaft den aktuellen Taschenlampenmodus zurück; ist die Publisher-Kamera nicht aktiviert, gibt der Abruf dieser Eigenschaft den bevorzugten Taschenlampenmodus zurück.

@property (nonatomic) BOOL cameraTorch

Angemeldet in

OTPublisher.h

cameraZoomFactor

Der bevorzugte Zoomfaktor (Verhältnis) für die Kamera. Der Wert 1,0 entspricht keinem Zoom (Standardansicht). Der Wert liegt zwischen 0,5 und dem maximalen Zoomfaktor. Werte zwischen 0,5 und 1,0 entsprechen einem Ultraweitwinkel (Herauszoomen), während Werte zwischen 1,0 und dem maximalen Zoomfaktor dem Heranzoomen entsprechen. Der tatsächlich angewandte Zoomfaktor wird automatisch auf den von der aktiven Kamerakonfiguration unterstützten Bereich begrenzt – wenn die Kamera keinen Ultraweitwinkel unterstützt, werden Zoomfaktoren unter 1,0 nicht wirksam und es wird kein Zoom angewendet. Bei Werten, die über dem von der Kamera unterstützten maximalen Zoomfaktor liegen, wird der Zoomfaktor auf den Maximalwert gesetzt. Ist die Publisher- Kamera aktiviert, gibt der Abruf dieser Eigenschaft den aktuellen Zoomfaktor zurück; ist die Publisher-Kamera nicht aktiviert, gibt der Abruf dieser Eigenschaft den bevorzugten Zoomfaktor zurück.

@property (nonatomic) float cameraZoomFactor

Angemeldet in

OTPublisher.h