AbstractSession

@interface AbstractSession : NSObject

@property (nonatomic,strong) JSValue *value;
@property (nonatomic,strong) PlayerAdapterHandler *playerAdapter;
@property (nonatomic,strong,nullable) JSValue *adEventsListenerJSValue;
@property (nonatomic,strong,nullable) JSValue *adDataListenerJSValue;
@property (nonatomic,strong,nullable) JSValue *multicastStatusListenerJSValue;

- (id)initWithJSValue:(JSValue *)value;

/**
 * Attach a player to the session to handle analytics
 *
 * <p>Workflow: attachPlayer(...) -> getURL(...) -> session is playing -> stopStreamingSession()</p>
 * <p>Note: call before getURL</p>
 *
 * @param player Player instance
 */
- (void)attachPlayer:(id)player;

/**
 * Attach a player to the session to handle analytics
 *
 * <p>Workflow: attachPlayer(...) -> getURL(...) -> session is playing -> stopStreamingSession()</p>
 * <p>Note: call before getURL</p>
 *
 * @param player Player instance
 * @param listener Listener instance (depending on the player you use)
 */
- (void)attachPlayer:(id)player listener:(nullable id)listener;

/**
 * Set an option for the current session. It does not replace values at the global level.
 *
 * <p>Note: It has to be called before getQuery and getURL.</p>
 *
 * @param option The option to update. The list if available as static constants values in class StreamingSessionOptions.
 * @param value Option value
 */
- (void)setOption:(int)option valueWithBool:(BOOL)value;

/**
 * Set an option for the current session. It does not replace values at the global level.
 *
 * <p>Note: It has to be called before getQuery and getURL.</p>
 *
 * @param option The option to update. The list if available as static constants values in class StreamingSessionOptions.
 * @param value Option value
 */
- (void)setOption:(int)option valueWithInt:(int)value;

/**
 * Set an option for the current session. It does not replace values at the global level.
 *
 * <p>Note: It has to be called before getQuery and getURL.</p>
 *
 * @param option The option to update. The list if available as static constants values in class StreamingSessionOptions.
 * @param value Option value
 */
- (void)setOption:(int)option valueWithString:(NSString *)value;

/**
 * Activate advertising workflow (including analytics and tracking)
 * The method setAdParameter automatically calls this method
 */
- (void)activateAdvertising;

/**
 * This method set a parameter used for the ad insertion
 * Activate the advertising workflow
 * @param name  Parameter name
 * @param value Parameter value
 */
- (void)setAdParameter:(NSString *)name value:(NSString *)value;

/**
 * Set ad view (PAL SDK)
 * @param view view object
 */
- (void)setAdView:(UIView *)view;

/**
 * Trigger an ad user interaction (OMSDK, PAL SDK)
 * @param interactionType see AdInteractionType class to get types
 */
- (void)adUserInteraction:(NSString *)interactionType;

/**
 * Set a custom parameter to be added to the session report
 *
 * <p>Note: Only sent during non-Broadpeak sessions</p>
 *
 * @param name Parameter name
 * @param value Parameter value
 */
- (void)setCustomParameter:(NSString *)name value:(NSString *)value;

/**
 * Set the ad events listener
 * Reset at SmartLib release
 *
 * @param listener Ad events listener
 */
- (void)setAdEventsListener:(nullable id<AdEventsListener>) listener;

/**
 * Set the ad events listener
 *
 * @param listener Ad events listener
 */
- (void)setAdDataListener:(nullable id<AdDataListener>) listener;

/**
 * Return the current ad list
 * It can be called after or inside onAdData event
 * @return list of ad breaks
 */
- (NSArray <AdBreakData *> *)getAdList;

/**
 * Return the current ad
 * @return current ad or nil
 */
- (AdData *)getCurrentAd;

/**
 * Return the current ad break
 * @return current ad break or nil
 */
- (AdBreakData *)getCurrentAdBreak;

/**
 * Return the current position within the content without ads
 * This position can be saved to be restored later through getPositionForPlayback(positionInBookmark)
 * For VOD contents only
 *
 * @return Position in milliseconds in the content without ads
 */
- (long)getPositionForBookmark;

/**
 * Return the position following current ads with the position in the content without ads
 * Can be called after or inside onAdData
 * For VOD contents only
 *
 * @param positionInBookmark position in milliseconds in the content without ad (with the stored value got from the method getPositionForBookmark())
 * @return Position following current ads in milliseconds
 */
- (long)getPositionForPlayback:(long)positionInBookmark;

/**
 * Set the multicast status listener
 * Reset at SmartLib release
 *
 * @param listener Multicast status listener
 */
- (void)setMulticastStatusListener:(nullable id<MulticastStatusListener>) listener;

@end