Windows Dev Center

Advanced capture properties for Windows Phone 8

Applies to: Windows Phone 8 and Windows Phone Silverlight 8.1 only

This topic describes the camera, photo, audio, and video properties that you can use for advanced capture scenarios in Windows Phone apps. Because different phones may support different sets of properties, they are not explicitly defined as object properties. Instead, the PhotoCaptureDevice and AudioVideoCaptureDevice objects provide the SetProperty and GetProperty methods to assign properties to the capture device. For more info about setting properties, see Advanced photo capture for Windows Phone 8.

Important noteImportant Note:

To determine which properties are supported on each phone, use the GetSupportedPropertyValues and GetSupportedPropertyRange methods. Each property will support one of these methods, but not both. A valid call to the GetProperty method will always return a value of type Object. Use the tables in this topic to determine the object types that correspond to each property, and whether GetSupportedPropertyValues or GetSupportedPropertyRange can be used with each property.

This topic contains the following sections.

Use the KnownCameraGeneralProperties class to assign general camera properties. Properties in this class can be assigned to both types of capture device objects, PhotoCaptureDevice and AudioVideoCaptureDevice. The KnownCameraGeneralProperties class returns GUID values that you can use with the capture device GetProperty and SetProperty methods. You can also assign these properties to the DesiredProperties property of a frame.

For each property, the following table lists the type of object that is returned by GetProperty, and whether GetSupportedPropertyValues (the “get values” column) or GetSupportedPropertyRange (the “get range” column) can be used.

Camera property

Object type

Get values

Get range

AutoFocusRange

AutoFocusRange

green check mark

EncodeWithOrientation

System.Int32

green check mark

IsShutterSoundEnabledByUser

System.Boolean

green check mark

IsShutterSoundRequiredForRegion

System.Boolean

green check mark

ManualFocusPosition

System.UInt32

green check mark

PlayShutterSoundOnCapture

System.Boolean

green check mark

SpecifiedCaptureOrientation

System.Int32

green check mark

Photo properties are only applicable to the PhotoCaptureDevice object. The KnownCameraPhotoProperties class returns GUID values that you can use with the GetProperty and SetProperty methods. You can also assign these properties to the DesiredProperties property of a frame.

For each property, the following table lists the type of object that is returned by GetProperty, and whether GetSupportedPropertyValues (the “get values” column) or GetSupportedPropertyRange (the “get range” column) can be used.

Photo property

Object type

Get values

Get range

ExposureCompensation

System.Int32

green check mark

ExposureTime

System.UInt32

green check mark

FlashMode

FlashState

green check mark

FlashPower

System.UInt32

green check mark

FocusIlluminationMode

FocusIlluminationMode

green check mark

Iso

System.UInt32

green check mark

LockedAutoFocusParameters

AutoFocusParameters

green check mark

ManualWhiteBalance

System.UInt32

green check mark

SceneMode

CameraSceneMode

green check mark

WhiteBalancePreset

WhiteBalancePreset

green check mark

Audio and video properties are only applicable to the AudioVideoCaptureDevice object. The KnownCameraAudioVideoProperties class returns GUID values that you can use with the GetProperty and SetProperty methods.

For each property, the following table lists the type of object that is returned by GetProperty, and whether GetSupportedPropertyValues (the “get values” column) or GetSupportedPropertyRange (the “get range” column) can be used.

Audio/video property

Object type

Get values

Get range

H264EnableKeyframes

System.Boolean

green check mark

H264EncodingLevel

H264EncoderLevel

green check mark

H264EncodingProfile

H264EncoderProfile

green check mark

H264QuantizationParameter

System.UInt32

green check mark

H264RequestDropNextNFrames

System.UInt32

green check mark

H264RequestIdrFrame

System.Boolean

green check mark

UnmuteAudioWhileRecording

System.Boolean

green check mark

VideoFrameRate

System.UInt32

green check mark

VideoTorchMode

VideoTorchMode

green check mark

VideoTorchPower

System.UInt32

green check mark

Show:
© 2015 Microsoft