AVCaptureSession Classe

Définition

Espace de noms:

AVFoundation

Assembly:

Xamarin.iOS.dll

Coordonne une session d’enregistrement.

[Foundation.Register("AVCaptureSession", true)]
[ObjCRuntime.Unavailable(ObjCRuntime.PlatformName.WatchOS, ObjCRuntime.PlatformArchitecture.All, null)]
[ObjCRuntime.Unavailable(ObjCRuntime.PlatformName.TvOS, ObjCRuntime.PlatformArchitecture.All, null)]
public class AVCaptureSession : Foundation.NSObject

type AVCaptureSession = class
    inherit NSObject

Héritage

Object

NSObject

AVCaptureSession

Attributs

RegisterAttribute UnavailableAttribute

Remarques

L’objet AVCaptureSession coordonne l’enregistrement de l’entrée vidéo ou audio et transmet les informations enregistrées à un ou plusieurs objets de sortie. À mesure que la ligne iOS a progressé, différents appareils ont gagné plusieurs appareils de capture (en particulier, gagné plusieurs caméras). Les développeurs d’applications peuvent utiliser DefaultDeviceWithMediaType(String) ou DevicesWithMediaType(String), en passant les constantes définies dans AVMediaType.

La configuration de la capture consiste à définir les Inputs propriétés et Outputs de .AVCaptureSession Notez que plusieurs AVCaptureInputs et AVCaptureOutputs sont possibles. Par exemple, pour capturer à la fois l’audio et la vidéo, vous devez utiliser deux entrées de capture :

var session = new AVCaptureSession();

var camera = AVCaptureDevice.DefaultDeviceWithMediaType(AVMediaType.Video);
var mic = AVCaptureDevice.DefaultDeviceWithMediaType(AVMediaType.Audio);
if(camera == null || mic == null){
    throw new Exception("Can't find devices");
}

var cameraInput = AVCaptureDeviceInput.FromDevice (camera);
//info.plist _must_ contain NSMicrophoneUsageDescription key
var micInput = AVCaptureDeviceInput.FromDevice (mic);

if(session.CanAddInput(cameraInput)){
    session.AddInput(cameraInput);
}
if(session.CanAddInput(micInput)){
   session.AddInput(micInput);
}

Notez que l’autorisation d’accéder au microphone (et, dans certaines régions, à la caméra) doit être donnée par l’utilisateur, ce qui oblige le développeur à ajouter au NSMicrophoneUsageDescription fichier info.plist de l’application.

La vidéo peut être capturée directement dans un fichier avec AVCaptureMovieFileOutput. Toutefois, cette classe n’a pas de données pouvant être affichées et ne peut pas être utilisée simultanément avec AVCaptureVideoDataOutput. Au lieu de cela, les développeurs d’applications peuvent l’utiliser en combinaison avec un AVCaptureVideoPreviewLayer, comme illustré dans l’exemple suivant :

var layer = new AVCaptureVideoPreviewLayer (session);
layer.VideoGravity = AVLayerVideoGravity.ResizeAspectFill;

var cameraView = new UIView ();
cameraView.Layer.AddSublayer (layer);

var filePath = Path.Combine (Path.GetTempPath (), "temporary.mov");
var fileUrl = NSUrl.FromFilename (filePath);

var movieFileOutput = new AVCaptureMovieFileOutput ();
var recordingDelegate = new MyRecordingDelegate ();
session.AddOutput (movieFileOutput);

movieFileOutput.StartRecordingToOutputFile (fileUrl, recordingDelegate);

Les développeurs d’applications doivent noter que la fonction StopRecording() est asynchrone ; les développeurs doivent attendre la FinishedRecording(AVCaptureFileOutput, NSUrl, NSObject[], NSError) méthode déléguée avant de manipuler le fichier (par exemple, avant de l’enregistrer dans l’album Photos avec SaveToPhotosAlbum(String, UIVideo+SaveStatus) ou WriteVideoToSavedPhotosAlbumAsync(NSUrl)).

public class MyRecordingDelegate : AVCaptureFileOutputRecordingDelegate
{
    public override void FinishedRecording (AVCaptureFileOutput captureOutput, NSUrl outputFileUrl, NSObject [] connections, NSError error)
    {
        if (UIVideo.IsCompatibleWithSavedPhotosAlbum (outputFileUrl.Path))
        {
            var library = new ALAssetsLibrary ();
            library.WriteVideoToSavedPhotosAlbum (outputFileUrl, (path, e2) =>
            {
                if (e2 != null)
                {
                    new UIAlertView ("Error", e2.ToString (), null, "OK", null).Show ();
                }
                else
                {
                    new UIAlertView ("Saved", "Saved to Photos", null, "OK", null).Show ();
                    File.Delete (outputFileUrl.Path);
                }
            });
        }
        else
        {
            new UIAlertView ("Incompatible", "Incompatible", null, "OK", null).Show ();
        }

    }
}          

Les développeurs d’applications peuvent configurer un ou plusieurs ports de sortie pour les données capturées, et il peut s’agir d’images, de trames vidéo avec des informations de minutage, d’exemples audio, de fichiers vidéo quicktime ou d’un rendu direct vers une couche CoreAnimation.

Une fois les composants d’entrée et de sortie de la session définis, le traitement réel commence en appelant la StartRunning() méthode .

void SetupCapture ()
	/ configure the capture session for low resolution, change this if your code
	// can cope with more data or volume
	session = new AVCaptureSession () {
	        SessionPreset = AVCaptureSession.PresetMedium
	};

	// create a device input and attach it to the session
	var captureDevice = AVCaptureDevice.DefaultDeviceWithMediaType (AVMediaType.Video);
	var input = AVCaptureDeviceInput.FromDevice (captureDevice);
	if (input == null){
	        Console.WriteLine ("No video input device");
	        return false;
	}
	session.AddInput (input);

	// create a VideoDataOutput and add it to the sesion
	var output = new AVCaptureVideoDataOutput () {
	        VideoSettings = new AVVideoSettings (CVPixelFormatType.CV32BGRA),

	        // If you want to cap the frame rate at a given speed, in this sample: 15 frames per second
	        MinFrameDuration = new CMTime (1, 15)
	};

	// configure the output
	queue = new MonoTouch.CoreFoundation.DispatchQueue ("myQueue");
	outputRecorder = new OutputRecorder ();
	output.SetSampleBufferDelegateAndQueue (outputRecorder, queue);
	session.AddOutput (output);

	session.StartRunning ();
}

public class OutputRecorder : AVCaptureVideoDataOutputSampleBufferDelegate {
        public override void DidOutputSampleBuffer (AVCaptureOutput captureOutput, CMSampleBuffer sampleBuffer, AVCaptureConnection connection)
        {
                try {
                        var image = ImageFromSampleBuffer (sampleBuffer);

                        // Do something with the image, we just stuff it in our main view.
                        AppDelegate.ImageView.BeginInvokeOnMainThread (delegate {
                                AppDelegate.ImageView.Image = image;
                        });

                        //
                        // Although this looks innocent "Oh, he is just optimizing this case away"
                        // this is incredibly important to call on this callback, because the AVFoundation
                        // has a fixed number of buffers and if it runs out of free buffers, it will stop
                        // delivering frames.
                        //
                        sampleBuffer.Dispose ();
                } catch (Exception e){
                        Console.WriteLine (e);
                }
        }

        UIImage ImageFromSampleBuffer (CMSampleBuffer sampleBuffer)
        {
                // Get the CoreVideo image
                using (var pixelBuffer = sampleBuffer.GetImageBuffer () as CVPixelBuffer){
                        // Lock the base address
                        pixelBuffer.Lock (0);
                        // Get the number of bytes per row for the pixel buffer
                        var baseAddress = pixelBuffer.BaseAddress;
                        int bytesPerRow = pixelBuffer.BytesPerRow;
                        int width = pixelBuffer.Width;
                        int height = pixelBuffer.Height;
                        var flags = CGBitmapFlags.PremultipliedFirst | CGBitmapFlags.ByteOrder32Little;
                        // Create a CGImage on the RGB colorspace from the configured parameter above
                        using (var cs = CGColorSpace.CreateDeviceRGB ())
                        using (var context = new CGBitmapContext (baseAddress,width, height, 8, bytesPerRow, cs, (CGImageAlphaInfo) flags))
                        using (var cgImage = context.ToImage ()){
                                pixelBuffer.Unlock (0);
                                return UIImage.FromImage (cgImage);
                        }
                }
        }
}

Constructeurs

AVCaptureSession()	Constructeur par défaut qui initialise une nouvelle instance de cette classe sans paramètres.
AVCaptureSession(IntPtr)	Constructeur utilisé lors de la création de représentations managées d’objets non managés ; Appelé par le runtime.
AVCaptureSession(NSObjectFlag)	Constructeur pour appeler des classes dérivées pour ignorer l’initialisation et simplement allouer l’objet.

Propriétés

AutomaticallyConfiguresApplicationAudioSession	Indique si utilise AVCaptureSession la session audio partagée de l’application.
AutomaticallyConfiguresCaptureDeviceForWideColor	Obtient ou définit une valeur booléenne qui contrôle si la session doit utiliser automatiquement une couleur large si elle est disponible.
Class	Coordonne une session d’enregistrement. (Hérité de NSObject)
ClassHandle	Handle pour cette classe.
DebugDescription	Description significative de cet objet. (Hérité de NSObject)
Description	Description de l’objet, la version Objective-C de ToString. (Hérité de NSObject)
DidStartRunningNotification	Constante de notification pour DidStartRunning
DidStopRunningNotification	Constante de notification pour DidStopRunning
ErrorKey	Représente la valeur associée à la constante AVCaptureSessionErrorKey
Handle	Handle (pointeur) vers la représentation d’objet non managée. (Hérité de NSObject)
Inputs	Entrées dans la session de capture.
Interrupted	Indique si la session a été interrompue.
InterruptionEndedNotification	Constante de notification pour InterruptionEnded
InterruptionReasonKey	Obtient une clé qui accède à la raison pour laquelle une session de capture a été interrompue.
InterruptionSystemPressureStateKey	Coordonne une session d’enregistrement.
IsDirectBinding	Coordonne une session d’enregistrement. (Hérité de NSObject)
IsProxy	Coordonne une session d’enregistrement. (Hérité de NSObject)
MasterClock	Horloge en lecture seule qui fournit une base de temps pour la synchronisation des horodatages à partir de plusieurs appareils d’entrée.
Outputs	Sorties pour la session de capture.
Preset1280x720	Représente la valeur associée à la constante AVCaptureSessionPreset1280x720
Preset1920x1080	Représente la valeur associée à la constante AVCaptureSessionPreset1920x1080
Preset352x288	Représente la valeur associée à la constante AVCaptureSessionPreset352x288
Preset3840x2160	Représente la valeur associée à la constante AVCaptureSessionPreset3840x2160.
Preset640x480	Représente la valeur associée à la constante AVCaptureSessionPreset640x480
PresetHigh	Représente la valeur associée à la constante AVCaptureSessionPresetHigh
PresetiFrame1280x720	Représente la valeur associée à la constante AVCaptureSessionPresetiFrame1280x720
PresetiFrame960x540	Représente la valeur associée à la constante AVCaptureSessionPresetiFrame960x540
PresetInputPriority	Représente la valeur associée à la constante AVCaptureSessionPresetInputPriority
PresetLow	Représente la valeur associée à la constante AVCaptureSessionPresetLow
PresetMedium	Représente la valeur associée à la constante AVCaptureSessionPresetMedium
PresetPhoto	Représente la valeur associée à la constante AVCaptureSessionPresetPhoto
RetainCount	Retourne le nombre de rétention Objective-C actuel pour l’objet. (Hérité de NSObject)
Running	Indique si la session de capture est en cours d’exécution.
RuntimeErrorNotification	Constante de notification pour RuntimeError
Self	Coordonne une session d’enregistrement. (Hérité de NSObject)
SessionPreset	Présélection de session.
Superclass	Coordonne une session d’enregistrement. (Hérité de NSObject)
SuperHandle	Handle utilisé pour représenter les méthodes de la classe de base pour ce NSObject. (Hérité de NSObject)
UsesApplicationAudioSession	Indique si la session doit utiliser la session audio partagée de l’application.
WasInterruptedNotification	Constante de notification pour WasInterrupted
Zone	Coordonne une session d’enregistrement. (Hérité de NSObject)

Méthodes

AddConnection(AVCaptureConnection)	Ajoute la capture connectionspécifiée.
AddInput(AVCaptureInput)	Ajoute une entrée à la session de capture
AddInputWithNoConnections(AVCaptureInput)	Ajoute le spécifié input sans former de nouvelles connexions.
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Inscrit un objet pour être observé en externe (à l’aide de NSString keyPath).   Les modifications observées sont envoyées à la méthode objet ObserveValue(NSString, NSObject, NSDictionary, IntPtr) de l’observateur. (Hérité de NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Inscrit un objet pour être observé en externe (à l’aide de la chaîne keyPath).   Les modifications observées sont envoyées à la méthode objet ObserveValue(NSString, NSObject, NSDictionary, IntPtr) de l’observateur. (Hérité de NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Inscrit un objet pour être observé en externe à l’aide d’une méthode arbitraire. (Hérité de NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Inscrit un objet pour être observé en externe à l’aide d’une méthode arbitraire. (Hérité de NSObject)
AddOutput(AVCaptureOutput)	Ajoute une sortie à la session de capture.
AddOutputWithNoConnections(AVCaptureOutput)	Ajoute le spécifié output sans former de nouvelles connexions.
AwakeFromNib()	Appelé après le chargement de l’objet à partir du fichier nib. Les remplaçants doivent appeler base. AwakeFromNib(). (Hérité de NSObject)
BeginConfiguration()	Lance une transaction pour modifier la configuration de la session de capture.
BeginInvokeOnMainThread(Action)	Coordonne une session d’enregistrement. (Hérité de NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Appelle de manière asynchrone le code spécifié sur le thread d’interface utilisateur principal. (Hérité de NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Coordonne une session d’enregistrement. (Hérité de NSObject)
Bind(String, NSObject, String, NSDictionary)	Coordonne une session d’enregistrement. (Hérité de NSObject)
BindingInfo(String)	Coordonne une session d’enregistrement. (Hérité de NSObject)
BindingOptionDescriptions(String)	Coordonne une session d’enregistrement. (Hérité de NSObject)
BindingValueClass(String)	Coordonne une session d’enregistrement. (Hérité de NSObject)
CanAddConnection(AVCaptureConnection)	Retourne true si le spécifié connection peut être ajouté.
CanAddInput(AVCaptureInput)	Retourne si l’entrée donnée peut être ajoutée à la session.
CanAddOutput(AVCaptureOutput)	Retourne si l’entrée donnée peut être ajoutée à la session.
CanSetSessionPreset(NSString)	Indique si la session prend en charge un ensemble particulier de paramètres de capture prédéfinis.
CommitConfiguration()	Applique de manière atomique toutes les modifications de configuration qui ont été apportées à la session de capture depuis BeginConfiguration().
CommitEditing()	Coordonne une session d’enregistrement. (Hérité de NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Coordonne une session d’enregistrement. (Hérité de NSObject)
ConformsToProtocol(IntPtr)	Appelé pour déterminer si cet objet implémente le protocole spécifié. (Hérité de NSObject)
Copy()	Effectue une copie de l’objet Objective-C sous-jacent. (Hérité de NSObject)
DangerousAutorelease()	Coordonne une session d’enregistrement. (Hérité de NSObject)
DangerousRelease()	Coordonne une session d’enregistrement. (Hérité de NSObject)
DangerousRetain()	Coordonne une session d’enregistrement. (Hérité de NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Indique qu’une modification s’est produite aux index pour une relation à plusieurs. (Hérité de NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Coordonne une session d’enregistrement. (Hérité de NSObject)
DidChangeValue(String)	Indique qu’une modification s’est produite sur la clé spécifiée. (Hérité de NSObject)
Dispose()	Libère les ressources utilisées par l’objet NSObject. (Hérité de NSObject)
Dispose(Boolean)	Libère les ressources utilisées par l’objet NSObject. (Hérité de NSObject)
DoesNotRecognizeSelector(Selector)	Indique que cet objet ne reconnaît pas le sélecteur spécifié. (Hérité de NSObject)
Equals(NSObject)	Coordonne une session d’enregistrement. (Hérité de NSObject)
Equals(Object)	Coordonne une session d’enregistrement. (Hérité de NSObject)
ExposedBindings()	Coordonne une session d’enregistrement. (Hérité de NSObject)
GetBindingInfo(NSString)	Coordonne une session d’enregistrement. (Hérité de NSObject)
GetBindingOptionDescriptions(NSString)	Coordonne une session d’enregistrement. (Hérité de NSObject)
GetBindingValueClass(NSString)	Coordonne une session d’enregistrement. (Hérité de NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Récupère les valeurs des clés spécifiées. (Hérité de NSObject)
GetHashCode()	Génère un code de hachage pour l’instance actuelle. (Hérité de NSObject)
GetMethodForSelector(Selector)	Coordonne une session d’enregistrement. (Hérité de NSObject)
GetNativeField(String)	Obsolète. Coordonne une session d’enregistrement. (Hérité de NSObject)
GetNativeHash()	Coordonne une session d’enregistrement. (Hérité de NSObject)
Init()	Coordonne une session d’enregistrement. (Hérité de NSObject)
InitializeHandle(IntPtr)	Coordonne une session d’enregistrement. (Hérité de NSObject)
InitializeHandle(IntPtr, String)	Coordonne une session d’enregistrement. (Hérité de NSObject)
Invoke(Action, Double)	Coordonne une session d’enregistrement. (Hérité de NSObject)
Invoke(Action, TimeSpan)	Coordonne une session d’enregistrement. (Hérité de NSObject)
InvokeOnMainThread(Action)	Coordonne une session d’enregistrement. (Hérité de NSObject)
InvokeOnMainThread(Selector, NSObject)	Appelle de manière synchrone le code spécifié sur le thread d’interface utilisateur principal. (Hérité de NSObject)
IsEqual(NSObject)	Coordonne une session d’enregistrement. (Hérité de NSObject)
IsKindOfClass(Class)	Coordonne une session d’enregistrement. (Hérité de NSObject)
IsMemberOfClass(Class)	Coordonne une session d’enregistrement. (Hérité de NSObject)
MarkDirty()	Promeut un objet homologue normal (IsDirectBinding a la valeur true) en objet toggleref. (Hérité de NSObject)
MutableCopy()	Crée une copie mutable du NSObject spécifié. (Hérité de NSObject)
ObjectDidEndEditing(NSObject)	Coordonne une session d’enregistrement. (Hérité de NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Indique que la valeur au keyPath spécifié par rapport à cet objet a changé. (Hérité de NSObject)
PerformSelector(Selector)	Coordonne une session d’enregistrement. (Hérité de NSObject)
PerformSelector(Selector, NSObject)	Coordonne une session d’enregistrement. (Hérité de NSObject)
PerformSelector(Selector, NSObject, Double)	Appelle le sélecteur sur l’instance actuelle et, si le obj n’est pas null, il le transmet en tant que paramètre unique. (Hérité de NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Coordonne une session d’enregistrement. (Hérité de NSObject)
PerformSelector(Selector, NSObject, NSObject)	Coordonne une session d’enregistrement. (Hérité de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Coordonne une session d’enregistrement. (Hérité de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Coordonne une session d’enregistrement. (Hérité de NSObject)
PrepareForInterfaceBuilder()	Coordonne une session d’enregistrement. (Hérité de NSObject)
RemoveConnection(AVCaptureConnection)	Supprime le connection spécifié.
RemoveInput(AVCaptureInput)	Supprime la source d’entrée spécifiée.
RemoveObserver(NSObject, NSString)	Empêche l’observateur spécifié de recevoir d’autres notifications de valeurs modifiées pour le keyPath spécifié. (Hérité de NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Empêche l’observateur spécifié de recevoir d’autres notifications de valeurs modifiées pour le keyPath et le contexte spécifiés. (Hérité de NSObject)
RemoveObserver(NSObject, String)	Empêche l’observateur spécifié de recevoir d’autres notifications de valeurs modifiées pour le keyPath spécifié. (Hérité de NSObject)
RemoveObserver(NSObject, String, IntPtr)	Empêche l’observateur spécifié de recevoir d’autres notifications de valeurs modifiées pour le keyPath et le contexte spécifiés. (Hérité de NSObject)
RemoveOutput(AVCaptureOutput)	Supprime la sortie spécifiée.
RespondsToSelector(Selector)	Indique si cet objet reconnaît le sélecteur spécifié. (Hérité de NSObject)
SetNativeField(String, NSObject)	Obsolète. Coordonne une session d’enregistrement. (Hérité de NSObject)
SetNilValueForKey(NSString)	Définit la valeur null de la clé spécifiée. (Hérité de NSObject)
SetValueForKey(NSObject, NSString)	Définit la valeur de la propriété spécifiée par la clé à la valeur spécifiée. (Hérité de NSObject)
SetValueForKeyPath(IntPtr, NSString)	Constructeur utilisé lors de la création de représentations managées d’objets non managés ; Appelé par le runtime. (Hérité de NSObject)
SetValueForKeyPath(NSObject, NSString)	Définit la valeur d’une propriété accessible à l’aide d’un chemin de clé. (Hérité de NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Indique une tentative d’écriture d’une valeur dans une clé non définie. S’il n’est pas remplacé, déclenche une exception NSUndefinedKeyException. (Hérité de NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Définit les valeurs de ce NSObject sur celles du dictionnaire spécifié. (Hérité de NSObject)
StartRunning()	Démarre le flux d’entrées et de sorties.
StopRunning()	Arrête de manière asynchrone le flux d’entrées et de sorties.
ToString()	Retourne une représentation sous forme de chaîne de la valeur de l’instance actuelle. (Hérité de NSObject)
Unbind(NSString)	Coordonne une session d’enregistrement. (Hérité de NSObject)
Unbind(String)	Coordonne une session d’enregistrement. (Hérité de NSObject)
ValueForKey(NSString)	Retourne la valeur de la propriété associée à la clé spécifiée. (Hérité de NSObject)
ValueForKeyPath(NSString)	Retourne la valeur d’une propriété accessible à l’aide d’un chemin de clé. (Hérité de NSObject)
ValueForUndefinedKey(NSString)	Indique une tentative de lecture d’une valeur d’une clé non définie. S’il n’est pas remplacé, déclenche une exception NSUndefinedKeyException. (Hérité de NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Indique que les valeurs des index spécifiés dans la clé spécifiée sont sur le point de changer. (Hérité de NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Coordonne une session d’enregistrement. (Hérité de NSObject)
WillChangeValue(String)	Indique que la valeur de la clé spécifiée est sur le point de changer. (Hérité de NSObject)

Méthodes d’extension

GetDebugDescription(INSObjectProtocol)	Coordonne une session d’enregistrement.
GetAccessibilityCustomRotors(NSObject)	Obtient le tableau d’objets UIAccessibilityCustomRotor appropriés pour l’objet this .
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Définit le tableau d’objets UIAccessibilityCustomRotor approprié pour l’objet this .

Voir aussi

• avcaptureframes
• Documentation Apple pour AVCaptureSession