O'Reilly logo

Beginning PhoneGap by Thomas Myer

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Chapter 14

Capture

WHAT YOU WILL LEARN IN THIS CHAPTER:

  • Understanding how to capture video
  • Understanding how to capture audio
  • Understanding how to capture images
  • Understanding how to handle errors

In earlier chapters, you learned how to use the Media and Camera objects to capture audio and photos, respectively. The PhoneGap API also lets you capture video, audio, and photos with the Capture API.

In this chapter, you learn how to use the Capture objects and methods.

LEARNING ABOUT CAPTURING VIDEO

To capture video on your device, use the device.capture.captureVideo method, as shown here:

navigator.device.capture.captureVideo(onSuccess, onError, options);

The success callback contains the captured video, and the error callback alerts you to any problems that you may encounter. Specifically, the success callback is invoked with an array of MediaFile objects, each describing a captured video clip file.

Using the options Argument

The options argument can contain the following items:

  • limit — This is the maximum number of video clips the user can capture at a time. It defaults to 1, but must be greater than or equal to 1.
  • duration — This is the maximum duration of the video clip (in seconds).
  • mode — This is the selected video capture mode. The value must match a recognized video mode (video/quicktime, video/3gpp, and so on).
Image

NOTE The 3GPP format (sometimes known as 3GP) is a multimedia ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required