//申請(qǐng)用戶語(yǔ)音識(shí)別權(quán)限
 [SFSpeechRecognizer requestAuthorization:^(SFSpeechRecognizerAuthorizationStatus status) { 
 }];

typedef NS_ENUM(NSInteger, SFSpeechRecognizerAuthorizationStatus) {
 //結(jié)果未知 用戶尚未進(jìn)行選擇
 SFSpeechRecognizerAuthorizationStatusNotDetermined,
 //用戶拒絕授權(quán)語(yǔ)音識(shí)別
 SFSpeechRecognizerAuthorizationStatusDenied,
 //設(shè)備不支持語(yǔ)音識(shí)別功能
 SFSpeechRecognizerAuthorizationStatusRestricted,
 //用戶授權(quán)語(yǔ)音識(shí)別
 SFSpeechRecognizerAuthorizationStatusAuthorized,
};

 //創(chuàng)建語(yǔ)音識(shí)別操作類對(duì)象
 SFSpeechRecognizer * rec = [[SFSpeechRecognizer alloc]init];
 //通過(guò)一個(gè)音頻路徑創(chuàng)建音頻識(shí)別請(qǐng)求
 SFSpeechRecognitionRequest * request = [[SFSpeechURLRecognitionRequest alloc]initWithURL:[[NSBundle mainBundle] URLForResource:@"7011" withExtension:@"m4a"]];
 //進(jìn)行請(qǐng)求
 [rec recognitionTaskWithRequest:request resultHandler:^(SFSpeechRecognitionResult * _Nullable result, NSError * _Nullable error) {
  //打印語(yǔ)音識(shí)別的結(jié)果字符串
  NSLog(@"%@",result.bestTranscription.formattedString);
 }];

//獲取當(dāng)前用戶權(quán)限狀態(tài)
+ (SFSpeechRecognizerAuthorizationStatus)authorizationStatus;
//申請(qǐng)語(yǔ)音識(shí)別用戶權(quán)限
+ (void)requestAuthorization:(void(^)(SFSpeechRecognizerAuthorizationStatus status))handler;
//獲取所支持的所有語(yǔ)言環(huán)境
+ (NSSet<NSLocale *> *)supportedLocales;
//初始化方法 需要注意 這個(gè)初始化方法將默認(rèn)以設(shè)備當(dāng)前的語(yǔ)言環(huán)境作為語(yǔ)音識(shí)別的語(yǔ)言環(huán)境
- (nullable instancetype)init;
//初始化方法 設(shè)置一個(gè)特定的語(yǔ)言環(huán)境
- (nullable instancetype)initWithLocale:(NSLocale *)locale NS_DESIGNATED_INITIALIZER;
//語(yǔ)音識(shí)別是否可用
@property (nonatomic, readonly, getter=isAvailable) BOOL available;
//語(yǔ)音識(shí)別操作類協(xié)議代理
@property (nonatomic, weak) id<SFSpeechRecognizerDelegate> delegate;
//設(shè)置語(yǔ)音識(shí)別的配置參數(shù) 需要注意 在每個(gè)語(yǔ)音識(shí)別請(qǐng)求中也有這樣一個(gè)屬性 這里設(shè)置將作為默認(rèn)值
//如果SFSpeechRecognitionRequest對(duì)象中也進(jìn)行了設(shè)置 則會(huì)覆蓋這里的值
/*
typedef NS_ENUM(NSInteger, SFSpeechRecognitionTaskHint) {
 SFSpeechRecognitionTaskHintUnspecified = 0,  // 無(wú)定義
 SFSpeechRecognitionTaskHintDictation = 1,  // 正常的聽寫風(fēng)格
 SFSpeechRecognitionTaskHintSearch = 2,   // 搜索風(fēng)格
 SFSpeechRecognitionTaskHintConfirmation = 3, // 短語(yǔ)風(fēng)格
};
*/
@property (nonatomic) SFSpeechRecognitionTaskHint defaultTaskHint;
//使用回調(diào)Block的方式進(jìn)行語(yǔ)音識(shí)別請(qǐng)求 請(qǐng)求結(jié)果會(huì)在Block中傳入
- (SFSpeechRecognitionTask *)recognitionTaskWithRequest:(SFSpeechRecognitionRequest *)request
           resultHandler:(void (^)(SFSpeechRecognitionResult * __nullable result, NSError * __nullable error))resultHandler;
//使用代理回調(diào)的方式進(jìn)行語(yǔ)音識(shí)別請(qǐng)求
- (SFSpeechRecognitionTask *)recognitionTaskWithRequest:(SFSpeechRecognitionRequest *)request
            delegate:(id <SFSpeechRecognitionTaskDelegate>)delegate;
//設(shè)置請(qǐng)求所占用的任務(wù)隊(duì)列
@property (nonatomic, strong) NSOperationQueue *queue;

//當(dāng)語(yǔ)音識(shí)別操作可用性發(fā)生改變時(shí)會(huì)被調(diào)用
- (void)speechRecognizer:(SFSpeechRecognizer *)speechRecognizer availabilityDidChange:(BOOL)available;

//當(dāng)開始檢測(cè)音頻源中的語(yǔ)音時(shí)首先調(diào)用此方法
- (void)speechRecognitionDidDetectSpeech:(SFSpeechRecognitionTask *)task;
//當(dāng)識(shí)別出一條可用的信息后 會(huì)調(diào)用
/*
需要注意，apple的語(yǔ)音識(shí)別服務(wù)會(huì)根據(jù)提供的音頻源識(shí)別出多個(gè)可能的結(jié)果 每有一條結(jié)果可用 都會(huì)調(diào)用此方法
*/
- (void)speechRecognitionTask:(SFSpeechRecognitionTask *)task didHypothesizeTranscription:(SFTranscription *)transcription;
//當(dāng)識(shí)別完成所有可用的結(jié)果后調(diào)用
- (void)speechRecognitionTask:(SFSpeechRecognitionTask *)task didFinishRecognition:(SFSpeechRecognitionResult *)recognitionResult;
//當(dāng)不再接受音頻輸入時(shí)調(diào)用 即開始處理語(yǔ)音識(shí)別任務(wù)時(shí)調(diào)用
- (void)speechRecognitionTaskFinishedReadingAudio:(SFSpeechRecognitionTask *)task;
//當(dāng)語(yǔ)音識(shí)別任務(wù)被取消時(shí)調(diào)用
- (void)speechRecognitionTaskWasCancelled:(SFSpeechRecognitionTask *)task;
//語(yǔ)音識(shí)別任務(wù)完成時(shí)被調(diào)用
- (void)speechRecognitionTask:(SFSpeechRecognitionTask *)task didFinishSuccessfully:(BOOL)successfully;

//此任務(wù)的當(dāng)前狀態(tài)
/*
typedef NS_ENUM(NSInteger, SFSpeechRecognitionTaskState) {
 SFSpeechRecognitionTaskStateStarting = 0,  // 任務(wù)開始
 SFSpeechRecognitionTaskStateRunning = 1,  // 任務(wù)正在運(yùn)行
 SFSpeechRecognitionTaskStateFinishing = 2,  // 不在進(jìn)行音頻讀入 即將返回識(shí)別結(jié)果
 SFSpeechRecognitionTaskStateCanceling = 3,  // 任務(wù)取消
 SFSpeechRecognitionTaskStateCompleted = 4,  // 所有結(jié)果返回完成
};
*/
@property (nonatomic, readonly) SFSpeechRecognitionTaskState state;
//音頻輸入是否完成
@property (nonatomic, readonly, getter=isFinishing) BOOL finishing;
//手動(dòng)完成音頻輸入 不再接收音頻
- (void)finish;
//任務(wù)是否被取消
@property (nonatomic, readonly, getter=isCancelled) BOOL cancelled;
//手動(dòng)取消任務(wù)
- (void)cancel;

@interface SFSpeechAudioBufferRecognitionRequest : SFSpeechRecognitionRequest

@property (nonatomic, readonly) AVAudioFormat *nativeAudioFormat;
//拼接音頻流
- (void)appendAudioPCMBuffer:(AVAudioPCMBuffer *)audioPCMBuffer;
- (void)appendAudioSampleBuffer:(CMSampleBufferRef)sampleBuffer;
//完成輸入
- (void)endAudio;

@end

//識(shí)別到的多套語(yǔ)音轉(zhuǎn)換信息數(shù)組 其會(huì)按照準(zhǔn)確度進(jìn)行排序
@property (nonatomic, readonly, copy) NSArray<SFTranscription *> *transcriptions;
//準(zhǔn)確性最高的識(shí)別實(shí)例
@property (nonatomic, readonly, copy) SFTranscription *bestTranscription;
//是否已經(jīng)完成 如果YES 則所有所有識(shí)別信息都已經(jīng)獲取完成
@property (nonatomic, readonly, getter=isFinal) BOOL final;

//完整的語(yǔ)音識(shí)別準(zhǔn)換后的文本信息字符串
@property (nonatomic, readonly, copy) NSString *formattedString;
//語(yǔ)音識(shí)別節(jié)點(diǎn)數(shù)組
@property (nonatomic, readonly, copy) NSArray<SFTranscriptionSegment *> *segments;

//當(dāng)前節(jié)點(diǎn)識(shí)別后的文本信息
@property (nonatomic, readonly, copy) NSString *substring;
//當(dāng)前節(jié)點(diǎn)識(shí)別后的文本信息在整體識(shí)別語(yǔ)句中的位置
@property (nonatomic, readonly) NSRange substringRange;
//當(dāng)前節(jié)點(diǎn)的音頻時(shí)間戳
@property (nonatomic, readonly) NSTimeInterval timestamp;
//當(dāng)前節(jié)點(diǎn)音頻的持續(xù)時(shí)間
@property (nonatomic, readonly) NSTimeInterval duration;
//可信度/準(zhǔn)確度 0-1之間
@property (nonatomic, readonly) float confidence;
//關(guān)于此節(jié)點(diǎn)的其他可能的識(shí)別結(jié)果 
@property (nonatomic, readonly) NSArray<NSString *> *alternativeSubstrings;