//
//  BDSASRParameters.h
//  BDSpeechClient
//
//  Created by baidu on 16/6/6.
//  Copyright © 2016年 baidu. All rights reserved.
//

#ifndef BDSASRParameters_h
#define BDSASRParameters_h

#import <Foundation/Foundation.h>

#pragma mark - 开发者身份验证

/*
 * BDS_ASR_API_SECRET_KEYS
 * Value explanation:   设置API_KEY and SECRET_KEY
 * Value type:          NSArray
 * Default value:       -
 */
extern NSString* BDS_ASR_API_SECRET_KEYS;


#pragma mark - 识别器参数配置

/*
 * BDS_ASR_SAMPLE_RATE
 * Value explanation:   设置录音采样率，自动模式根据当前网络情况自行调整
 * Value type:          TVoiceRecognitionRecordSampleRateFlags
 * Default value:       @(EVoiceRecognitionRecordSampleRate16K)
 */
extern NSString* BDS_ASR_SAMPLE_RATE;

/*
 * BDS_ASR_STRATEGY
 * Value explanation:   语音识别策略
 * Value type:          TBDVoiceRecognitionStrategy
 * Default value:       @(EVR_STRATEGY_ONLINE)
 */
extern NSString* BDS_ASR_STRATEGY;

/*
 * BDS_ASR_CITY_ID
 * Value explanation:   设置城市ID，仅对地图识别类型有效
 * Value type:          NSInteger
 * Default value:       @(1)（全国）
 */
extern NSString* BDS_ASR_CITY_ID;

/*
 * BDS_ASR_PROPERTY_LIST
 * Value explanation:   设置识别类型列表，输入法不可与其他类型复合
 * Value type:          NSArray[TBDVoiceRecognitionProperty]
 * Default value:       @[@(EVoiceRecognitionPropertySearch)]
 */
extern NSString* BDS_ASR_PROPERTY_LIST;

/*
 * BDS_ASR_LANGUAGE
 * Value explanation:   设置识别语言
 * Value type:          TVoiceRecognitionLanguage
 * Default value:       @(EVoiceRecognitionLanguageChinese)
 */
extern NSString* BDS_ASR_LANGUAGE;

/*
 * BDS_ASR_ENABLE_NLU
 * Value explanation:   开启语义解析，将返回包含语义的json串
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_ENABLE_NLU;

/*
 * BDS_ASR_DISABLE_PUNCTUATION
 * Value explanation:   关闭输出标点
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_DISABLE_PUNCTUATION;

/*
 * BDS_ASR_ENABLE_CONTACTS
 * Value explanation:   开启通讯录识别功能，将优先返回通讯录识别结果，需事先用uploader上传通讯录
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_ENABLE_CONTACTS;

/*
 * BDS_ASR_ENABLE_LOCAL_VAD
 * Value explanation:   是否需要对录音数据进行端点检测，如果关闭，请同时关闭服务端提前返回：BDS_ASR_ENABLE_EARLY_RETURN
 * Value type:          BOOL
 * Default value:       @(YES)
 */
extern NSString* BDS_ASR_ENABLE_LOCAL_VAD;

/*
 * BDS_ASR_ENABLE_EARLY_RETURN
 * Value explanation:   服务端开启提前返回，即允许服务端在未收到客户端发送的结束标志前提前结束识别过程
 * Value type:          BOOL
 * Default value:       @(YES)
 */
extern NSString* BDS_ASR_ENABLE_EARLY_RETURN;

#pragma mark - 音频文件路径（文件识别）

/*
 * BDS_ASR_AUDIO_FILE_PATH
 * Value explanation:   设置音频文件路径（数据源）
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_AUDIO_FILE_PATH;

/*
 * BDS_ASR_AUDIO_INPUT_STREAM
 * Value explanation:   设置音频输入流（数据源）
 * Value type:          NSInputStream
 * Default value:       nil
 */
extern NSString* BDS_ASR_AUDIO_INPUT_STREAM;

/*
 * BDS_ASR_DISABLE_AUDIO_OPERATION
 * Value explanation:   Disable sdk audio operation (Set audio session disactive).
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_DISABLE_AUDIO_OPERATION;

#pragma mark - 提示音

/*
 * BDS_ASR_PLAY_TONE
 * Value explanation:   识别提示音设置，需添加相应声音文件，可替换
 * Value type:          TBDVoiceRecognitionPlayTones
 * Default value:       @(EVRPlayToneNone) （关闭提示音）
 */
extern NSString* BDS_ASR_PLAY_TONE;

#pragma mark - SDK 工作队列

/*
 * BDS_ASR_WORK_QUEUE
 * Value explanation:   指定SDK工作队列
 * Value type:          dispatch_queue_t
 * Default value:       main queue (dispatch_get_main_queue())
 * Example: dispatch_queue_create("queueLabel", DISPATCH_QUEUE_SERIAL)
 */
extern NSString* BDS_ASR_WORK_QUEUE;

#pragma mark - 日志级别

/*
 * BDS_ASR_DEBUG_LOG_LEVEL
 * Value explanation:   指定调试日志级别
 * Value type:          TBDVoiceRecognitionDebugLogLevel
 * Default value:       @(EVRDebugLogLevelOff)
 */
extern NSString* BDS_ASR_DEBUG_LOG_LEVEL;

#pragma mark - Offline Engine Verify

/*
 * BDS_ASR_OFFLINE_APP_CODE
 * Value explanation:   离线授权所需APPCODE（APPID），如使用该方式进行正式授权，请移除临时授权文件
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_OFFLINE_APP_CODE;

/*
 * BDS_ASR_OFFLINE_LICENSE_FILE_PATH
 * Value explanation:   离线授权文件路径
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_LICENSE_FILE_PATH;


#pragma mark - Offline Engine KWS

/*
 * BDS_ASR_OFFLINE_ENGINE_TYPE
 * Value explanation:   离线识别引擎类型
 * Value type:          TBDVoiceRecognitionOfflineEngineType
 * Default value:       @(EVR_OFFLINE_ENGINE_GRAMMER)
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_TYPE;

/*
 * BDS_ASR_OFFLINE_ENGINE_DAT_FILE_PATH
 * Value explanation:   离线识别资源文件路径
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_DAT_FILE_PATH;

/*
 * BDS_ASR_OFFLINE_ENGINE_GRAMMER_FILE_PATH
 * Value explanation:   离线识别语法文件路径
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_GRAMMER_FILE_PATH;

/*
 * BDS_ASR_OFFLINE_ENGINE_GRAMMER_SLOT
 * Value explanation:   语法模式离线语法槽，使用该参数更新离线语法文件
 * Value type:          NSString (@"{\"name\":[\"张三\",\"李四\"],\"appname\":[\"手白\",\"度秘\"]}")
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_GRAMMER_SLOT;

/*
 * BDS_ASR_OFFLINE_ENGINE_WAKEUP_WORDS_FILE_PATH
 * Value explanation:   唤醒词文件路径，使用了唤醒并使用离线语法识别的情况下需要设置，其他情况请忽略该参数
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_WAKEUP_WORDS_FILE_PATH;

#pragma mark - VR from Wakeup

/*
 * BDS_ASR_OFFLINE_ENGINE_TRIGGERED_WAKEUP_WORD
 * Value explanation:   当前触发唤醒词，唤醒后立即调用识别的情况下配置，其他情况请忽略该参数
 * Value type:          NSString
 * Default value:       @""
 */
extern NSString* BDS_ASR_OFFLINE_ENGINE_TRIGGERED_WAKEUP_WORD;

/*
 * BDS_ASR_NEED_CACHE_AUDIO
 * Value explanation:   唤醒后立刻进行识别需开启该参数，其他情况请忽略该参数
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_NEED_CACHE_AUDIO;


#pragma mark - 服务端配置

/*
 * BDS_ASR_PRODUCT_ID
 * Value explanation:   设置产品ID
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_PRODUCT_ID;

/*
 * BDS_ASR_SERVER_URL
 * Value explanation:   设置服务器地址
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_SERVER_URL;

/*
 * BDS_ASR_BROWSER_USER_AGENT
 * Value explanation:   设置浏览器标识(Http request header)，资源返回时会根据UA适配
 * Value type:          NSString
 * Default value:       -（可通过[UIWebView stringByEvaluatingJavaScriptFromString:@"navigator.userAgent"]获取）
 */
extern NSString* BDS_ASR_BROWSER_USER_AGENT;

/*
 * BDS_ASR_LOCATION
 * Value explanation:   更新当前地理位置信息，与地理位置相关的资源会优先返回附近资源信息, 请传入通过GPS获取到的经纬度数据
 * Value type:          CLLocation
 * Default value:       -
 */
extern NSString* BDS_ASR_LOCATION;


#pragma mark - 识别器扩展配置

/*
 * BDS_ASR_PROTOCOL
 * Value explanation:   设置协议类型
 * Value type:          TBDVoiceRecognitionProtocol
 * Default value:       @(EPROTOCOL_DEFAULT)
 */
extern NSString* BDS_ASR_PROTOCOL;

/*
 * BDS_ASR_COMPRESSION_TYPE
 * Value explanation:   录音数据压缩算法
 * Value type:          TBDVoiceRecognitionAudioCompressionType
 * Default value:       @(EVR_AUDIO_COMPRESSION_BV32)
 */
extern NSString* BDS_ASR_COMPRESSION_TYPE;

/*
 * BDS_ASR_ENABLE_DRC
 * Value explanation:   是否进行车载环境下的噪声消除
 * Value type:          BOOL
 * Default value:       @(NO)
 */
extern NSString* BDS_ASR_ENABLE_DRC;


#pragma mark - 扩展参数

/*
 * BDS_ASR_BUA
 * Value explanation:   扩展参数，浏览器标识
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_BUA;

/*
 * BDS_ASR_PAM
 * Value explanation:   扩展参数，多轮对话需要的信息
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_PAM;

/*
 * BDS_ASR_STC
 * Value explanation:   扩展参数，统计信息
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_STC;

/*
 * BDS_ASR_LTP
 * Value explanation:   扩展参数，轻应用参数（uid）
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_LTP;

/*
 * BDS_ASR_TXT
 * Value explanation:   扩展参数，上传文本，如果设置了该字段，将略过语音输入和识别阶段（暂不支持）
 * Value type:          NSString
 * Default value:       -
 */
extern NSString* BDS_ASR_TXT;


#endif /* BDSASRParameters_h */