talk-ios/ThirdParty/AppRTC/ARDSettingsModel.h

91 строка
2.8 KiB
Objective-C

/*
* Copyright 2016 The WebRTC Project Authors. All rights reserved.
*
* Use of this source code is governed by a BSD-style license
* that can be found in the LICENSE file in the root of the source
* tree. An additional intellectual property rights grant can be found
* in the file PATENTS. All contributing project authors may
* be found in the AUTHORS file in the root of the source tree.
*/
#import <Foundation/Foundation.h>
NS_ASSUME_NONNULL_BEGIN
/**
* Model class for user defined settings.
*
* Handles storing the settings and provides default values if setting is not
* set. Also provides list of available options for different settings. Stores
* for example video codec, video resolution and maximum bitrate.
*/
@interface ARDSettingsModel : NSObject
/**
* Returns array of available capture resoultions.
*
* The capture resolutions are represented as strings in the following format
* [width]x[height]
*/
- (NSArray<NSString *> *)availableVideoResolutions;
/**
* Returns current video resolution string.
* If no resolution is in store, default value of 640x480 is returned.
* When defaulting to value, the default is saved in store for consistency reasons.
*/
- (NSString *)currentVideoResolutionSettingFromStore;
- (NSString *)readableResolution:(NSString *)resolution;
- (int)currentVideoResolutionWidthFromStore;
- (int)currentVideoResolutionHeightFromStore;
/**
* Stores the provided video resolution string into the store.
*
* If the provided resolution is no part of the available video resolutions
* the store operation will not be executed and NO will be returned.
* @param resolution the string to be stored.
* @return YES/NO depending on success.
*/
- (BOOL)storeVideoResolutionSetting:(NSString *)resolution;
/**
* Video disabled by default on call starts
*/
- (BOOL)videoDisabledSettingFromStore;
- (void)storeVideoDisabledDefault:(BOOL)disabled;
/**
* Returns array of available video codecs.
*/
- (NSArray<NSString *> *)availableVideoCodecs;
/**
* Returns current video codec setting from store if present or default (H264) otherwise.
*/
- (NSString *)currentVideoCodecSettingFromStore;
/**
* Stores the provided video codec setting into the store.
*
* If the provided video codec is not part of the available video codecs
* the store operation will not be executed and NO will be returned.
* @param video codec settings the string to be stored.
* @return YES/NO depending on success.
*/
- (BOOL)storeVideoCodecSetting:(NSString *)videoCodec;
/**
* Returns current max bitrate setting from store if present.
*/
- (nullable NSNumber *)currentMaxBitrateSettingFromStore;
/**
* Stores the provided bitrate value into the store.
*
* @param bitrate NSNumber representation of the max bitrate value.
*/
- (void)storeMaxBitrateSetting:(nullable NSNumber *)bitrate;
@end
NS_ASSUME_NONNULL_END