///
/// Copyright (c) 2016 Dropbox, Inc. All rights reserved.
///
/// Auto-generated by Stone, do not modify.
///

#import <Foundation/Foundation.h>

#import "DBSerializableProtocol.h"

@class DBFILESDimensions;
@class DBFILESGpsCoordinates;
@class DBFILESMediaMetadata;

#pragma mark - API Object

///
/// The `MediaMetadata` struct.
///
/// Metadata for a photo or video.
///
/// This class implements the `DBSerializable` protocol (serialize and
/// deserialize instance methods), which is required for all Obj-C SDK API route
/// objects.
///
@interface DBFILESMediaMetadata : NSObject <DBSerializable>

#pragma mark - Instance fields

/// Dimension of the photo/video.
@property (nonatomic, readonly) DBFILESDimensions * _Nullable dimensions;

/// The GPS coordinate of the photo/video.
@property (nonatomic, readonly) DBFILESGpsCoordinates * _Nullable location;

/// The timestamp when the photo/video is taken.
@property (nonatomic, readonly) NSDate * _Nullable timeTaken;

#pragma mark - Constructors

///
/// Full constructor for the struct (exposes all instance variables).
///
/// @param dimensions Dimension of the photo/video.
/// @param location The GPS coordinate of the photo/video.
/// @param timeTaken The timestamp when the photo/video is taken.
///
/// @return An initialized instance.
///
- (nonnull instancetype)initWithDimensions:(DBFILESDimensions * _Nullable)dimensions
                                  location:(DBFILESGpsCoordinates * _Nullable)location
                                 timeTaken:(NSDate * _Nullable)timeTaken;

///
/// Convenience constructor (exposes only non-nullable instance variables with
/// no default value).
///
///
/// @return An initialized instance.
///
- (nonnull instancetype)init;

@end

#pragma mark - Serializer Object

///
/// The serialization class for the `MediaMetadata` struct.
///
@interface DBFILESMediaMetadataSerializer : NSObject

///
/// Serializes `DBFILESMediaMetadata` instances.
///
/// @param instance An instance of the `DBFILESMediaMetadata` API object.
///
/// @return A json-compatible dictionary representation of the
/// `DBFILESMediaMetadata` API object.
///
+ (NSDictionary * _Nonnull)serialize:(DBFILESMediaMetadata * _Nonnull)instance;

///
/// Deserializes `DBFILESMediaMetadata` instances.
///
/// @param dict A json-compatible dictionary representation of the
/// `DBFILESMediaMetadata` API object.
///
/// @return An instantiation of the `DBFILESMediaMetadata` object.
///
+ (DBFILESMediaMetadata * _Nonnull)deserialize:(NSDictionary * _Nonnull)dict;

@end
