# SparkChain 大模型识别 Android SDK集成文档

dependencies { 
    implementation files('libs/SparkChain.aar')    
}

<application android:requestLegacyExternalStorage="true"/>

-keep class com.iflytek.sparkchain.** {*;} 
-keep class com.iflytek.sparkchain.**

//配置应用信息 
SparkChainConfig config =  SparkChainConfig.builder()        
    .appID("$appId")        
    .apiKey("$apiKey")        
    .apiSecret("$apiSecret"); 
int ret = SparkChain.getInst().init(getApplicationContext(), config); 

public class ASR {    
    public ASR() {            
    
    }
    
    public ASR(String language, String domain, String accent) {        
        ...    
    } 
}

ASR asr = new ASR("mul_cn","slm","mandarin");
//ASR asr = new ASR();//缺省参数调用方式

asr.language("mul_cn");
asr.accent("mandarin");
...
asr.domain("slm");
asr.vinfo(true);

public interface AsrCallbacks {    
    void onResult(ASR.ASRResult asrResult, Object usrContext);     
    void onError(ASR.ASRError asrError, Object usrContext); 
}

AsrCallbacks mAsrCallbacks = new AsrCallbacks() { 
    @Override    
    public void onResult(ASR.ASRResult asrResult, Object o) {    	
        int vad_begin  = -1;        
        int vad_end    = -1;        
        String word    = null;        
        String result  = asrResult.getBestMatchText();//解析识别结果        
        int status     = asrResult.getStatus();//解析结果返回状态        
        String sid     = asrResult.getSid();//解析sid        
        //以下信息需要开发者根据自身需求，如无必要，可不需要解析执行。        
        List<Vad> vads = asrResult.getVads();//解析vad结构体                     
        for(Vad vad:vads){        	
            vad_begin = vad.getBegin();//解析vad前端点            
            vad_end   = vad.getEnd();//解析vad后端点            
        }        
        List<Transcription> transcriptions = asrResult.getTranscriptions();//解析具体结果信息           
        for(Transcription transcription : transcriptions){            
            List<Segment> segments = transcription.getSegments();//解析中文分词结构体            
            for(Segment segment:segments){                
                word = segment.getText();//解析词语            
            }        
        } 
    }    
    @Override    
    public void onError(ASR.ASRError asrError, Object o) {    	
        int errCode   = asrError.getCode();//错误码        
        String errMsg = asrError.getErrMsg();//错误信息        
        String sid    = asrError.getSid();//本次交互的sid    
    } 
}; 
asr.registerCallbacks(mAsrCallbacks);

public class AudioAttributes { 
    public AudioAttributes() {            
    
    }         
    public void setSampleRate(int mSampleRate) {        
        ...    
    }     
    public void setEncoding(String mEncoding) {        
        ...    
    }
    public void setChannels(int channels) {
        ... 
    }
    public void setBitdepth(int bitdepth) {
        ... 
    }
    public void setFrameSize(int frameSize) {
        ...
    }
} 
public class ASR {    
    public int start(Object usrTag) {        
        ...    
    }     
    public int start(AudioAttributes attributes, Object usrTag) {        
        ...    
    } 
}

asr.start();
//带有数据信息结构体的构建方式示例如下：
//AudioAttributes atr = new AudioAttributes();
//atr.setSampleRate(16000);
//atr.setEncoding("raw");
//atr.setChannels(1);
//asr.start(atr, null);

public class ASR {    
    public int write(byte[] data) {        
        ...    
    } 
}

通过是否传入speex_size（speex音频帧长，仅在speex音频时使用）参数来区分 
1、当传入speex_size参数时，会当成标准开源格式进行处理 
2、当未传入speex_size参数时，会当成讯飞定制格式进行处理

byte[] data = new byte[1280]; 
...//省略获取音频的过程 
asr.write(data);

public class ASR {    
    public int stop(boolean immediate) {        
        ...    
    } 
}

asr.stop(false);

SparkChain.getInst().unInit();