Package apple.avfoundation

Class AVCaptureSession

  • All Implemented Interfaces:
    NSObject
    Direct Known Subclasses:
    AVCaptureMultiCamSession
    public class AVCaptureSession
extends NSObject
    AVCaptureSession AVCaptureSession is the central hub of the AVFoundation capture classes. To perform a real-time capture, a client may instantiate AVCaptureSession and add appropriate AVCaptureInputs, such as AVCaptureDeviceInput, and outputs, such as AVCaptureMovieFileOutput. [AVCaptureSession startRunning] starts the flow of data from the inputs to the outputs, and [AVCaptureSession stopRunning] stops the flow. A client may set the sessionPreset property to customize the quality level or bitrate of the output.

    • Constructor Detail

      • AVCaptureSession

        protected AVCaptureSession​(org.moe.natj.general.Pointer peer)

    • Method Detail

      • accessInstanceVariablesDirectly

        public static boolean accessInstanceVariablesDirectly()

      • allocWithZone

        public static java.lang.Object allocWithZone​(org.moe.natj.general.ptr.VoidPtr zone)

      • automaticallyNotifiesObserversForKey

        public static boolean automaticallyNotifiesObserversForKey​(java.lang.String key)

      • cancelPreviousPerformRequestsWithTarget

        public static void cancelPreviousPerformRequestsWithTarget​(java.lang.Object aTarget)

      • cancelPreviousPerformRequestsWithTargetSelectorObject

        public static void cancelPreviousPerformRequestsWithTargetSelectorObject​(java.lang.Object aTarget,
                                                                         org.moe.natj.objc.SEL aSelector,
                                                                         java.lang.Object anArgument)

      • classFallbacksForKeyedArchiver

        public static NSArray<java.lang.String> classFallbacksForKeyedArchiver()

      • classForKeyedUnarchiver

        public static org.moe.natj.objc.Class classForKeyedUnarchiver()

      • debugDescription_static

        public static java.lang.String debugDescription_static()

      • description_static

        public static java.lang.String description_static()

      • hash_static

        public static long hash_static()

      • instanceMethodSignatureForSelector

        public static NSMethodSignature instanceMethodSignatureForSelector​(org.moe.natj.objc.SEL aSelector)

      • instancesRespondToSelector

        public static boolean instancesRespondToSelector​(org.moe.natj.objc.SEL aSelector)

      • isSubclassOfClass

        public static boolean isSubclassOfClass​(org.moe.natj.objc.Class aClass)

      • keyPathsForValuesAffectingValueForKey

        public static NSSet<java.lang.String> keyPathsForValuesAffectingValueForKey​(java.lang.String key)

      • new_objc

        public static java.lang.Object new_objc()

      • resolveClassMethod

        public static boolean resolveClassMethod​(org.moe.natj.objc.SEL sel)

      • resolveInstanceMethod

        public static boolean resolveInstanceMethod​(org.moe.natj.objc.SEL sel)

      • setVersion_static

        public static void setVersion_static​(long aVersion)

      • superclass_static

        public static org.moe.natj.objc.Class superclass_static()

      • version_static

        public static long version_static()

      • addConnection

        public void addConnection​(AVCaptureConnection connection)
        addConnection: Adds an AVCaptureConnection to the session. An AVCaptureConnection instance can only be added to a session using -addConnection: if canAddConnection: returns YES. When using -addInput: or -addOutput:, connections are formed automatically between all compatible inputs and outputs. Manually adding connections is only necessary when adding an input or output with no connections. -addConnection: may be called while the session is running.
        Parameters:
        connection - An AVCaptureConnection instance.

      • addInput

        public void addInput​(AVCaptureInput input)
        addInput: Adds an AVCaptureInput to the session. An AVCaptureInput instance can only be added to a session using -addInput: if -canAddInput: returns YES. -addInput: may be called while the session is running.
        Parameters:
        input - An AVCaptureInput instance.

      • addInputWithNoConnections

        public void addInputWithNoConnections​(AVCaptureInput input)
        addInputWithNoConnections: Adds an AVCaptureInput to the session without forming any connections. -addInputWithNoConnections: may be called while the session is running. The -addInput: method is the preferred method for adding an input to an AVCaptureSession. -addInputWithNoConnections: may be called if you need fine-grained control over which inputs are connected to which outputs.
        Parameters:
        input - An AVCaptureInput instance.

      • addOutput

        public void addOutput​(AVCaptureOutput output)
        addOutput: Adds an AVCaptureOutput to the session. An AVCaptureOutput instance can only be added to a session using -addOutput: if -canAddOutput: returns YES. -addOutput: may be called while the session is running.
        Parameters:
        output - An AVCaptureOutput instance.

      • addOutputWithNoConnections

        public void addOutputWithNoConnections​(AVCaptureOutput output)
        addOutputWithNoConnections: Adds an AVCaptureOutput to the session without forming any connections. -addOutputWithNoConnections: may be called while the session is running. The -addOutput: method is the preferred method for adding an output to an AVCaptureSession. -addOutputWithNoConnections: may be called if you need fine-grained control over which inputs are connected to which outputs.
        Parameters:
        output - An AVCaptureOutput instance.

      • automaticallyConfiguresApplicationAudioSession

        public boolean automaticallyConfiguresApplicationAudioSession()
        [@property] automaticallyConfiguresApplicationAudioSession Indicates whether the receiver should configure the application's audio session for recording. The value of this property is a BOOL indicating whether the receiver should configure the application's audio session when needed for optimal recording. When set to YES, the receiver ensures the application's audio session is set to the PlayAndRecord category, and picks an appropriate microphone and polar pattern to match the video camera being used. When set to NO, and -usesApplicationAudioSession is set to YES, the receiver will use the application's audio session, but will not change any of its properties. If the session is not set up correctly for input, audio recording may fail. The default value is YES.

      • automaticallyConfiguresCaptureDeviceForWideColor

        public boolean automaticallyConfiguresCaptureDeviceForWideColor()
        [@property] automaticallyConfiguresCaptureDeviceForWideColor Indicates whether the receiver automatically configures its video device's activeFormat and activeColorSpace properties, preferring wide color for photos. The default value is YES. By default, the receiver automatically adjusts its source video AVCaptureDevice's activeFormat and activeColorSpace properties based on the supportedColorSpaces of the device's formats and the current AVCaptureSession topology. Wide color spaces are preferred over sRGB if an AVCapturePhotoOutput is present in the session. If you wish to set AVCaptureDevice's activeColorSpace manually, and prevent the AVCaptureSession from undoing your work, you must set automaticallyConfiguresCaptureDeviceForWideColor to NO. If the receiver's sessionPreset is set to AVCaptureSessionPresetInputPriority, the session will not alter the capture device's activeFormat, but might still alter its activeColorSpace.

      • beginConfiguration

        public void beginConfiguration()
        beginConfiguration When paired with commitConfiguration, allows a client to batch multiple configuration operations on a running session into atomic updates. -beginConfiguration / -commitConfiguration are AVCaptureSession's mechanism for batching multiple configuration operations on a running session into atomic updates. After calling [session beginConfiguration], clients may add or remove outputs, alter the sessionPreset, or configure individual AVCaptureInput or Output properties. All changes will be pended until the client calls [session commitConfiguration], at which time they will be applied together. -beginConfiguration / -commitConfiguration pairs may be nested, and will only be applied when the outermost commit is invoked.

      • canAddConnection

        public boolean canAddConnection​(AVCaptureConnection connection)
        canAddConnection: Returns whether the proposed connection can be added to the receiver. An AVCaptureConnection instance can only be added to a session using -addConnection: if canAddConnection: returns YES. When using -addInput: or -addOutput:, connections are formed automatically between all compatible inputs and outputs. Manually adding connections is only necessary when adding an input or output with no connections.
        Parameters:
        connection - An AVCaptureConnection instance.

      • canAddInput

        public boolean canAddInput​(AVCaptureInput input)
        canAddInput: Returns whether the proposed input can be added to the receiver. An AVCaptureInput instance can only be added to a session using -addInput: if -canAddInput: returns YES.
        Parameters:
        input - An AVCaptureInput instance.
        Returns:
        YES if the proposed input can be added to the receiver, NO otherwise.

      • canAddOutput

        public boolean canAddOutput​(AVCaptureOutput output)
        canAddOutput: Returns whether the proposed output can be added to the receiver. An AVCaptureOutput instance can only be added to a session using -addOutput: if -canAddOutput: returns YES.
        Parameters:
        output - An AVCaptureOutput instance.
        Returns:
        YES if the proposed output can be added to the receiver, NO otherwise.

      • canSetSessionPreset

        public boolean canSetSessionPreset​(java.lang.String preset)
        canSetSessionPreset: Returns whether the receiver can be configured with the given preset. An AVCaptureSession instance can be associated with a preset that configures its inputs and outputs to fulfill common use cases. This method can be used to determine if the receiver supports the desired preset given its current input and output configuration. The receiver's sessionPreset property may only be set to a certain preset if this method returns YES for that preset.
        Parameters:
        preset - An AVCaptureSession preset.
        Returns:
        YES if the receiver can be set to the given preset, NO otherwise.

      • commitConfiguration

        public void commitConfiguration()
        commitConfiguration When preceded by beginConfiguration, allows a client to batch multiple configuration operations on a running session into atomic updates. -beginConfiguration / -commitConfiguration are AVCaptureSession's mechanism for batching multiple configuration operations on a running session into atomic updates. After calling [session beginConfiguration], clients may add or remove outputs, alter the sessionPreset, or configure individual AVCaptureInput or Output properties. All changes will be pended until the client calls [session commitConfiguration], at which time they will be applied together. -beginConfiguration / -commitConfiguration pairs may be nested, and will only be applied when the outermost commit is invoked.

      • inputs

        public NSArray<? extends AVCaptureInput> inputs()
        [@property] inputs An NSArray of AVCaptureInputs currently added to the receiver. The value of this property is an NSArray of AVCaptureInputs currently added to the receiver. Clients can add AVCaptureInputs to a session by calling -addInput:.

      • isInterrupted

        public boolean isInterrupted()
        [@property] interrupted Indicates whether the session is being interrupted. The value of this property is a BOOL indicating whether the receiver is currently being interrupted, such as by a phone call or alarm. Clients can key value observe the value of this property to be notified when the session ceases to be interrupted and again has access to needed hardware resources.

      • isRunning

        public boolean isRunning()
        [@property] running Indicates whether the session is currently running. The value of this property is a BOOL indicating whether the receiver is running. Clients can key value observe the value of this property to be notified when the session automatically starts or stops running.

      • masterClock

        public CMClockRef masterClock()
        [@property] masterClock Provides the master clock being used for output synchronization. The masterClock is readonly. Use masterClock to synchronize AVCaptureOutput data with external data sources (e.g motion samples). All capture output sample buffer timestamps are on the masterClock timebase. For example, if you want to reverse synchronize the output timestamps to the original timestamps, you can do the following: In captureOutput:didOutputSampleBuffer:fromConnection: AVCaptureInputPort *port = [[connection inputPorts] objectAtIndex:0]; CMClockRef originalClock = [port clock]; CMTime syncedPTS = CMSampleBufferGetPresentationTime( sampleBuffer ); CMTime originalPTS = CMSyncConvertTime( syncedPTS, [session masterClock], originalClock ); This property is key-value observable.

      • outputs

        public NSArray<? extends AVCaptureOutput> outputs()
        [@property] outputs An NSArray of AVCaptureOutputs currently added to the receiver. The value of this property is an NSArray of AVCaptureOutputs currently added to the receiver. Clients can add AVCaptureOutputs to a session by calling -addOutput:.

      • removeConnection

        public void removeConnection​(AVCaptureConnection connection)
        removeConnection: Removes an AVCaptureConnection from the session. -removeConnection: may be called while the session is running.
        Parameters:
        connection - An AVCaptureConnection instance.

      • removeInput

        public void removeInput​(AVCaptureInput input)
        removeInput: Removes an AVCaptureInput from the session. -removeInput: may be called while the session is running.
        Parameters:
        input - An AVCaptureInput instance.

      • removeOutput

        public void removeOutput​(AVCaptureOutput output)
        removeOutput: Removes an AVCaptureOutput from the session. -removeOutput: may be called while the session is running.
        Parameters:
        output - An AVCaptureOutput instance.

      • sessionPreset

        public java.lang.String sessionPreset()
        [@property] sessionPreset Indicates the session preset currently in use by the receiver. The value of this property is an AVCaptureSessionPreset indicating the current session preset in use by the receiver. The sessionPreset property may be set while the receiver is running.

      • setAutomaticallyConfiguresApplicationAudioSession

        public void setAutomaticallyConfiguresApplicationAudioSession​(boolean value)
        [@property] automaticallyConfiguresApplicationAudioSession Indicates whether the receiver should configure the application's audio session for recording. The value of this property is a BOOL indicating whether the receiver should configure the application's audio session when needed for optimal recording. When set to YES, the receiver ensures the application's audio session is set to the PlayAndRecord category, and picks an appropriate microphone and polar pattern to match the video camera being used. When set to NO, and -usesApplicationAudioSession is set to YES, the receiver will use the application's audio session, but will not change any of its properties. If the session is not set up correctly for input, audio recording may fail. The default value is YES.

      • setAutomaticallyConfiguresCaptureDeviceForWideColor

        public void setAutomaticallyConfiguresCaptureDeviceForWideColor​(boolean value)
        [@property] automaticallyConfiguresCaptureDeviceForWideColor Indicates whether the receiver automatically configures its video device's activeFormat and activeColorSpace properties, preferring wide color for photos. The default value is YES. By default, the receiver automatically adjusts its source video AVCaptureDevice's activeFormat and activeColorSpace properties based on the supportedColorSpaces of the device's formats and the current AVCaptureSession topology. Wide color spaces are preferred over sRGB if an AVCapturePhotoOutput is present in the session. If you wish to set AVCaptureDevice's activeColorSpace manually, and prevent the AVCaptureSession from undoing your work, you must set automaticallyConfiguresCaptureDeviceForWideColor to NO. If the receiver's sessionPreset is set to AVCaptureSessionPresetInputPriority, the session will not alter the capture device's activeFormat, but might still alter its activeColorSpace.

      • setSessionPreset

        public void setSessionPreset​(java.lang.String value)
        [@property] sessionPreset Indicates the session preset currently in use by the receiver. The value of this property is an AVCaptureSessionPreset indicating the current session preset in use by the receiver. The sessionPreset property may be set while the receiver is running.

      • setUsesApplicationAudioSession

        public void setUsesApplicationAudioSession​(boolean value)
        [@property] usesApplicationAudioSession Indicates whether the receiver will use the application's AVAudioSession for recording. The value of this property is a BOOL indicating whether the receiver is currently using the application's AVAudioSession (see AVAudioSession.h). Prior to iOS 7, AVCaptureSession uses its own audio session, which can lead to unwanted interruptions when interacting with the application's audio session. In applications linked on or after iOS 7, AVCaptureSession shares the application's audio session, allowing for simultaneous play back and recording without unwanted interruptions. Clients desiring the pre-iOS 7 behavior may opt out by setting usesApplicationAudioSession to NO. The default value is YES.

      • startRunning

        public void startRunning()
        startRunning Starts an AVCaptureSession instance running. Clients invoke -startRunning to start the flow of data from inputs to outputs connected to the AVCaptureSession instance. This call blocks until the session object has completely started up or failed. A failure to start running is reported through the AVCaptureSessionRuntimeErrorNotification mechanism.

      • stopRunning

        public void stopRunning()
        stopRunning Stops an AVCaptureSession instance that is currently running. Clients invoke -stopRunning to stop the flow of data from inputs to outputs connected to the AVCaptureSession instance. This call blocks until the session object has completely stopped.

      • usesApplicationAudioSession

        public boolean usesApplicationAudioSession()
        [@property] usesApplicationAudioSession Indicates whether the receiver will use the application's AVAudioSession for recording. The value of this property is a BOOL indicating whether the receiver is currently using the application's AVAudioSession (see AVAudioSession.h). Prior to iOS 7, AVCaptureSession uses its own audio session, which can lead to unwanted interruptions when interacting with the application's audio session. In applications linked on or after iOS 7, AVCaptureSession shares the application's audio session, allowing for simultaneous play back and recording without unwanted interruptions. Clients desiring the pre-iOS 7 behavior may opt out by setting usesApplicationAudioSession to NO. The default value is YES.

      • connections

        public NSArray<? extends AVCaptureConnection> connections()
        [@property] connections An NSArray of AVCaptureConnections currently added to the receiver. The value of this property is an NSArray of AVCaptureConnections currently added to the receiver. Connections are formed implicitly by the receiver when a client calls -addInput: or -addOutput:. Connections are formed explicitly when a client calls -addConnection:.