Last Updated on : 2024-09-06 06:17:56
The timeline view component linearly displays the time points of SD card-stored or cloud-stored video footage to be played back. Users can slide the timeline and precisely locate the target time point and video clip to start playback.
Add the following code block to the Podfile:
platform :ios, '9.0'
target 'your_target_name' do
pod "TuyaCameraUIKit"
end
In the root directory of your project, run pod update
.
Class (Protocol) | Description |
---|---|
TuyaTimelineView | Timeline view class protocol, inherited from UIView |
TuyaTimelineViewDelegate | Timeline view delegate protocol |
TuyaTimelineViewSource | Timeline data source protocol |
Properties
Name | Type | Description |
---|---|---|
spacePerUnit | CGFloat | The width of each time unit that is enclosed by two consecutive long tick marks on the timeline. |
unitMode | Enum | The time unit mode. The value can be set to 60 seconds, 600 seconds, or 3,600 seconds. |
tickMarkColor | UIColor | The color of tick marks. |
backgroundGradientColors | NSArray | The array of gradient background colors of the timeline. |
backgroundGradientLocations | NSArray | The array of gradient positions for the timeline background colors. |
contentColor | UIColor | The data rendering colors on the timeline. Gradient colors are supported. |
contentGradientColors | NSArray | The array of gradient colors for rendering timeline data. |
contentGradientLocations | NSArray | The array of gradient positions for the timeline data rendering colors. |
timeHeaderHeight | CGFloat | The height of the time text bar. |
timeTextTop | CGFloat | The position of the time text on the y-axis. This property in tandem with timeHeaderHeight determines each data rendering position. |
timeStringAttributes | NSDictionary | The properties of time text. |
showTimeText | BOOL | Specifies whether to show time text. |
showShortMark | BOOL | Specifies whether to show short tick marks. |
currentTime | NSTimeInterval | The Unix timestamp currently selected on the timeline. |
date | NSDate | The specified date. |
timeZone | NSTimeZone | The specified time zone. |
isDragging | BOOL | Indicates whether the timeline is being dragged. |
isDecelerating | BOOL | Indicates whether the timeline is decelerating. |
midLineColor | UIColor | The color of the middle line on the timeline. |
selectionBoxColor | UIColor | The color of the selection frame on the timeline. |
selectedTimeRange | NSRange | The time range that is selected with the selection frame. |
isSelectionEnabled | BOOL | Specifies whether to enable the selection mode. |
selectionTimeBackgroundColor | UIColor | The background color of timeline labels in the selection frame. |
selectionTimeTextColor | UIColor | The text color of timeline labels in the selection frame. |
selectionTimeTextFontSize | UIColor | The font size of timeline labels in the selection frame. |
sourceModels | NSArray | The array of source data from which timeline data is retrieved. |
delegate | id | The timeline delegate. |
API description
- (void)enableSelectionModeWithMinLength:(NSInteger)min maxLength:(NSInteger)max;
Parameters
Parameter | Type | Description |
---|---|---|
min | NSInteger | The minimum duration that can be selected with the selection frame. |
max | NSInteger | The maximum duration that can be selected with the selection frame. |
API description
- (NSRange)finishSelection;
API description
If the parameter animated
is set to YES
, the timeline slides to the specified time point at a constant speed, and the delegate method - (void)timelineView:didEndScrollingAtTime:inSource:
is triggered.
- (void)setCurrentTime:(NSTimeInterval)currentTime animated:(BOOL)animated;
Parameters
Parameter | Type | Description |
---|---|---|
currentTime | NSTimeInterval | The time point currently selected on the timeline. |
animated | BOOL | Specifies whether to enable the animated mode. |
API description
- (void)timelineViewWillBeginDragging:(TuyaTimelineView *)timeLineView;
API description
If decelerate
is set to YES
, the timeline is set to be accelerating.
- (void)timelineViewDidEndDragging:(TuyaTimelineView *)timeLineView willDecelerate:(BOOL)decelerate;
API description
If isDragging
is set to YES
, the timeline is set to be moving.
- (void)timelineViewDidScroll:(TuyaTimelineView *)timeLineView time:(NSTimeInterval)timeInterval isDragging:(BOOL)isDragging;
API description
timeInterval
specifies the time point at which the timeline stops. source
specifies the data source for this time point.
- (void)timelineView:(TuyaTimelineView *)timeLineView didEndScrollingAtTime:(NSTimeInterval)timeInterval inSource:(id<TuyaTimelineViewSource>)source;
API description
unitMode
specifies the current time unit mode of the timeline.
- (void)timelineView:(TuyaTimelineView *)timeLineView scaleToUnitMode:(TuyaTimelineUnitMode)unitMode;
The API methods of the data source protocol are used to get the start time point and end time point of a time segment. The number of seconds is returned to indicate the date
parameter value.
API description
- (NSTimeInterval)startTimeIntervalSinceDate:(NSDate *)date;
API description
- (NSTimeInterval)stopTimeIntervalSinceDate:(NSDate *)date;
A timeline is used to render non-overlapping time segments on a date. For more information about code examples, see the files TYCameraTimeLineModel.m
and TYDemoCameraPlaybackViewController.m
files in the sample.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback