io.appium.java_client.ios

Class IOSStartScreenRecordingOptions

java.lang.Object

io.appium.java_client.screenrecording.BaseScreenRecordingOptions<BaseStartScreenRecordingOptions<T>>

io.appium.java_client.screenrecording.BaseStartScreenRecordingOptions<IOSStartScreenRecordingOptions>

io.appium.java_client.ios.IOSStartScreenRecordingOptions

public class IOSStartScreenRecordingOptions
extends BaseStartScreenRecordingOptions<IOSStartScreenRecordingOptions>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IOSStartScreenRecordingOptions.VideoQuality

Constructor Summary

Constructors

Constructor and Description
IOSStartScreenRecordingOptions()

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.Object>	build() Builds a map, which is ready to be passed to the subordinated Appium API.
static IOSStartScreenRecordingOptions	startScreenRecordingOptions()
IOSStartScreenRecordingOptions	withFps(int fps) The Frames Per Second rate of the recorded video.
IOSStartScreenRecordingOptions	withTimeLimit(java.time.Duration timeLimit) The maximum recording time.
IOSStartScreenRecordingOptions	withUploadOptions(ScreenRecordingUploadOptions uploadOptions) Upload options set for the recorded screen capture.
IOSStartScreenRecordingOptions	withVideoFilters(java.lang.String filters) The FFMPEG video filters to apply.
IOSStartScreenRecordingOptions	withVideoQuality(IOSStartScreenRecordingOptions.VideoQuality videoQuality) The video encoding quality (low, medium, high, photo - defaults to medium).
IOSStartScreenRecordingOptions	withVideoScale(java.lang.String videoScale) The scaling value to apply.
IOSStartScreenRecordingOptions	withVideoType(java.lang.String videoType) The video codec type used for encoding of the recorded screen capture.

Methods inherited from class io.appium.java_client.screenrecording.BaseStartScreenRecordingOptions

disableForcedRestart, enableForcedRestart

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IOSStartScreenRecordingOptions

public IOSStartScreenRecordingOptions()

Method Detail

startScreenRecordingOptions

public static IOSStartScreenRecordingOptions startScreenRecordingOptions()

withUploadOptions

public IOSStartScreenRecordingOptions withUploadOptions(ScreenRecordingUploadOptions uploadOptions)

Upload options set for the recorded screen capture.

Overrides:

withUploadOptions in class BaseScreenRecordingOptions<BaseStartScreenRecordingOptions<IOSStartScreenRecordingOptions>>

Parameters:

uploadOptions - see the documentation on ScreenRecordingUploadOptions for more details.

Returns:

self instance for chaining.

withVideoType

public IOSStartScreenRecordingOptions withVideoType(java.lang.String videoType)

The video codec type used for encoding of the recorded screen capture. Execute `ffmpeg -codecs` in the terminal to see the list of supported video codecs. 'mjpeg' by default.

Parameters:

videoType - one of available video codec names, for example 'libx264'.

Returns:

self instance for chaining.

Since:

Appium 1.10.0

withVideoQuality

public IOSStartScreenRecordingOptions withVideoQuality(IOSStartScreenRecordingOptions.VideoQuality videoQuality)

The video encoding quality (low, medium, high, photo - defaults to medium). Only works for real devices.

Parameters:

videoQuality - one of possible quality preset names.

Returns:

self instance for chaining.

withFps

public IOSStartScreenRecordingOptions withFps(int fps)

The Frames Per Second rate of the recorded video. Defaults to 10.

Parameters:

fps - frames per second value in range 1..60.

Returns:

self instance for chaining.

Since:

Appium 1.10.0

withVideoScale

public IOSStartScreenRecordingOptions withVideoScale(java.lang.String videoScale)

The scaling value to apply. Read https://trac.ffmpeg.org/wiki/Scaling for possible values. No scale is applied by default. If filters are set then the scale setting is effectively ignored.

Parameters:

videoScale - ffmpeg-compatible scale format specifier.

Returns:

self instance for chaining.

Since:

Appium 1.10.0

withTimeLimit

public IOSStartScreenRecordingOptions withTimeLimit(java.time.Duration timeLimit)

The maximum recording time. The default value is 180 seconds (3 minutes). The maximum value is 30 minutes. Setting values greater than this or less than zero will cause an exception. The minimum time resolution unit is one second.

Overrides:

withTimeLimit in class BaseStartScreenRecordingOptions<IOSStartScreenRecordingOptions>

Parameters:

timeLimit - The actual time limit of the recorded video.

Returns:

self instance for chaining.

withVideoFilters

public IOSStartScreenRecordingOptions withVideoFilters(java.lang.String filters)

The FFMPEG video filters to apply. These filters allow to scale, flip, rotate and do many other useful transformations on the source video stream. The format of the property must comply with https://ffmpeg.org/ffmpeg-filters.html.

Parameters:

filters - One or more filters to apply to the resulting video stream, for example "transpose=1" to rotate the resulting video 90 degrees clockwise.

Returns:

self instance for chaining.

Since:

Appium 1.15

build

public java.util.Map<java.lang.String,java.lang.Object> build()

Description copied from class: BaseScreenRecordingOptions

Builds a map, which is ready to be passed to the subordinated Appium API.

Overrides:

build in class BaseStartScreenRecordingOptions<IOSStartScreenRecordingOptions>

Returns:

arguments mapping.