Vue d'ensemble

Un éditeur capture un flux audio-vidéo à partir du microphone et de la caméra de l'appareil. Vous pouvez ensuite publier ce flux audio-vidéo dans une session OpenTok en envoyant le [OTSession publish:error:] message.

Le SDK OpenTok pour iOS prend en charge la publication sur tous les appareils iOS multicœurs. Consultez la section « Exigences pour les développeurs et les clients » dans le fichier README du SDK OpenTok pour iOS.

Notez que lors des tests dans le simulateur iOS, un objet OTPublisher utilise une vidéo de démonstration, car la caméra n'est pas disponible dans le simulateur.

Initialisation d'un éditeur

– initWithDelegate:settings:

Initialiser l'éditeur avec les paramètres définis par un OTPublisherSettings objet.

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

Paramètres

Déclaré à

OTPublisher.h

– initWithDelegate:name:cameraResolution:cameraFrameRate:

Initialiser un objet Publisher.

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

Paramètres

Valeur de retour

Le pointeur vers l'instance, ou nil si l'initialisation a échoué.

Discussion

Cette méthode est obsolète. Utilisez [OTPublisher initWithDelegate:settings:] au lieu de cela.

Cette méthode comprend des paramètres permettant de définir la résolution et la fréquence d'images de la vidéo de l'éditeur. Si vous utilisez une méthode d'initialisation héritée de OTPublisherKit, la résolution sera en VGA et la fréquence d'images sera de 30 images par seconde.

Pour les sessions qui utilisent OpenTok Media Router (dans les sessions où le mode multimédia est défini sur « routed »), la réduction de la fréquence d'images ou de la résolution diminue la bande passante maximale que le flux peut utiliser. En revanche, dans les sessions où le mode multimédia est défini sur « relayed », la réduction de la fréquence d'images ou de la résolution peut ne pas entraîner de diminution de la bande passante du flux.

Déclaré à

OTPublisher.h

Affichage de la vidéo

view

La vue de cet éditeur. Si cette vue s'affiche, elle présentera un aperçu du flux de la caméra active.

@property (readonly) UIView *view

Déclaré à

OTPublisher.h

viewScaleBehavior

Le redimensionnement de la vidéo rendue, tel que défini par le OTVideoViewScaleBehavior énumération. La valeur par défaut est OTVideoViewScaleBehaviorFill. Définissez-la sur OTVideoViewScaleBehaviorFit pour que la vidéo soit réduite, si nécessaire, de manière à ce qu’elle soit entièrement visible (avec des bandes noires). Cette propriété n’affecte que la vidéo de l’éditeur local. Les abonnés au flux doivent définir la [OTSubscriber viewScaleBehavior] propriété.

@property (nonatomic) OTVideoViewScaleBehavior viewScaleBehavior

Déclaré à

OTPublisher.h

Définition de la configuration de l'appareil de publication

cameraPosition

Position préférée de la caméra. Lorsque cette propriété est définie, si la modification est possible, l'éditeur utilisera la caméra avec la position spécifiée. Si l'éditeur a commencé la publication, l'appel de cette propriété renvoie la position actuelle de la caméra ; si l'éditeur n'a pas encore commencé la publication, l'appel de cette propriété renvoie la position préférée de la caméra.

@property (nonatomic) AVCaptureDevicePosition cameraPosition

Déclaré à

OTPublisher.h

cameraTorch

Mode « lampe de poche » (torche) préféré pour l'appareil photo. Définir cette propriété sur YES ou NO indique si l'éditeur doit activer ou désactiver la fonction « lampe de poche » de l'appareil photo lorsqu'elle est disponible. Notez qu’il s’agit d’une préférence qui peut ne pas s’appliquer si la caméra active ne prend pas en charge la fonctionnalité de flash (par exemple, la caméra avant ne prend généralement pas en charge le flash). Si la caméra de l’éditeur est activée, l’interrogation de cette propriété renvoie le mode « flash » actuel ; si la caméra de l’éditeur n’est pas activée, l’interrogation de cette propriété renvoie le mode « flash » préféré.

@property (nonatomic) BOOL cameraTorch

Déclaré à

OTPublisher.h

cameraZoomFactor

Le facteur de zoom (rapport) souhaité pour la caméra. Une valeur de 1,0 correspond à l'absence de zoom (vue par défaut). La valeur varie entre 0,5 et le facteur de zoom maximal. Les valeurs comprises entre 0,5 et 1,0 correspondent à un angle ultra-grand angle (zoom arrière) et celles comprises entre 1,0 et le facteur de zoom maximal correspondent à un zoom avant. Le facteur de zoom réel appliqué est automatiquement limité à la plage prise en charge par la configuration de la caméra active — si la caméra ne prend pas en charge l’ultra-grand angle, les facteurs de zoom inférieurs à 1,0 ne seront pas pris en compte et aucun zoom ne sera appliqué. Pour les valeurs supérieures au facteur de zoom maximal pris en charge par la caméra, le facteur de zoom sera défini sur la valeur maximale. Si la caméra de l’éditeur est activée, l’appel de cette propriété renvoie le facteur de zoom actuel ; si la caméra de l’éditeur n’est pas activée, l’appel de cette propriété renvoie le facteur de zoom préféré.

@property (nonatomic) float cameraZoomFactor

Déclaré à

OTPublisher.h