Instance Method

append(_:)

Appends a timed metadata group to the receiver.

Declaration

func append(_ timedMetadataGroup: AVTimedMetadataGroup) -> Bool

Parameters

timedMetadataGroup

The timed metadata group to be appended.

Return Value

true if the append was successful; otherwise, false. If the append fails the assetWriterInput instance's error property will contain more information about the failure.

Discussion

The timing of the metadata items in the output asset will correspond to the timeRange of the AVTimedMetadataGroup, regardless of the values of the time and duration properties of the individual metadata items.

Before calling this method, you must ensure that the input that underlies the receiver is attached to an AVAssetWriter instance by a prior call to add(_:) and that startWriting() has been invoked on the asset writer.