Instance Method

startVideoCapture

Starts video capture using the camera specified by the UIImagePickerControllerCameraDevice property.

Declaration

- (BOOL)startVideoCapture;

Return Value

YES on success or NO on failure. This method may return a value of NO for various reasons, among them the following:

  • Movie capture is already in progress

  • The device does not support movie capture

  • The device is out of disk space

Discussion

Use this method in conjunction with a custom overlay view to initiate the programmatic capture of a movie. You can take more than one movie without leaving the interface, but to do so requires you to hide the default image picker controls.

Calling this method while a movie is being captured has no effect. You must call the stopVideoCapture method, and then wait until the associated delegate object receives an imagePickerController:didFinishPickingMediaWithInfo: message, before you can capture another movie.

Calling this method when the source type of the image picker is set to a value other than UIImagePickerControllerSourceTypeCamera results in the throwing of an NSInvalidArgumentException exception.

If you require additional options or more control over movie capture, use the movie capture methods in the AVFoundation framework. Refer to AVFoundation.

See Also

Capturing Still Images or Movies

- takePicture

Captures a still image using the camera.

- stopVideoCapture

Stops video capture.