搜狗语音云开发入门（二）——使用离线语音识别服务

1 简单介绍

    之前在《搜狗语音云开发入门--移动端轻松加入高大上的语音识别》中介绍了使用搜狗语音云为client程序加入在线语音识别服务。

在线语音服务须要联网使用，可是你不能指望用户拥有完美的环境，其实大多数情况下用户的外围环境都会有所限制。

有的时候没有Wi-Fi、没有流量，还想使用语音识别，假设你给用户一个提示“您没开流量...”仅仅能说你的程序弱爆了。有条件情况下给用户提供完美的服务，没有条件创造条件服务质量依旧完美。而且清风徐来了无痕迹，这才是完美应用的体现。你不是用户的亲戚朋友同学战友，不是武藤苍井上原结衣小子玛利亚。不是黎明郭富城刘德华梁朝伟，也不是王朔海岩郭敬明韩寒，这些你统统不是。但你做的应用还是能让人喜欢用，赶都赶不走，那就是能力。不好意思扯远了。

 

2 提供的服务

    离线语音识别服务由两部分组成：搜狗离线语音识别引擎和开发API。

不能联网，语音引擎就转到你本地了。

而通过调用API，能够操作离线语音识别Service，对离线语音识别Service运行start、bind和unbind等操作。还能够获取结果，通过向Service发请求。获取离线语音识别结果或者出错信息。

 

3 怎样使用

 

3.1 使用步骤

    离线语音识别服务没有高速体验。所以须要使用必须进行服务的常规申请。

    登陆搜狗语音云开放平台：

    

    如图，首先点击“开发人员专区”，选择“离线识别”，然后填写具体的应用信息与开发人员信息。这里要注意的是，一定要准确填写你的“应用包名”，否则识别有问题。

    申请之后，语音云官方会进行审核。只是这个审核是须要一点时间的，通常是4天左右。

有须要的朋友们，还等什么。赶快先申请着再说！

    审核过程中。你随时能够点击右上角：账号 - 我的应用，查看审核结果。成功之后会有：

    

    能够看到基本信息列出来了，然后点击“应用信息”：

    

    关键是“appId”与“access-key”这两项，程序调用的时候须要用到，记得保存好。

3.2 调用服务

    在调用服务之前，须要先将SDK服务和服务文档下载下来：

    

    分别点击“SDK下载”中的“下载SDK”和“开发文档”，将两份文件下载：

    

    将SDK压缩文件解压后。里面有一个libs目录，进入后能够看到里面的文件：

    

    将它们放入你的Androidproject的libs里面，并在project中将sogou-speechapi-offline-v1.0.jar引入Build Path。

    

    下载搜狗离线语音识别引擎。

程序中的API正是调用的该引擎中的服务。注意，首次使用或者使用次数达到上限时，须要进行联网认证，其他时候离线就可以提供服务。

    

    接下来关注我们的Androidproject。

改动AndroidManifest.xml。须要确保app具有下面权限：    

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><span style="font-family: 宋体; background-color: rgb(255, 255, 255);"> </span>

    

    在Android中加入布局：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.testyuyinoffline.MainActivity" >

        <RelativeLayout 
            android:id="@id/textLayout"
	            android:layout_width="wrap_content"
	            android:layout_height="wrap_content" >
	        <TextView
	            android:id="@id/statusLabel"
	            android:layout_width="wrap_content"
	            android:layout_height="wrap_content"
	            android:layout_marginTop="20dip"
	            android:layout_marginLeft="30dip"
	            android:layout_alignParentLeft="true"
	            android:text="@string/statusLabel" />
	        
	        <TextView
	            android:id="@id/statusTextTv"
	            android:layout_width="wrap_content"
	            android:layout_height="wrap_content"
	            android:layout_marginTop="20dip"
	            android:layout_marginRight="20dip"
	            android:layout_alignParentRight="true"
	            android:text="@string/statusText" />
	        
	        <TextView
	            android:id="@id/toSayLabelTv"
	            android:layout_width="wrap_content"
	            android:layout_height="wrap_content"
	            android:layout_marginTop="20dip"
	            android:layout_marginLeft="30dip"
	            android:layout_alignParentLeft="true"
	            android:layout_below="@id/statusLabel"
	            android:text="@string/toSayLabel" />
	        
	        <TextView
	            android:id="@id/toSayTextTv"
	            android:layout_width="wrap_content"
	            android:layout_height="wrap_content"
	            android:layout_marginTop="20dip"
	            android:layout_marginRight="20dip"
	            android:layout_alignParentRight="true"
	            android:layout_below="@id/statusTextTv"
	            android:text="@string/toSayText" />
        </RelativeLayout>

        <Button
            android:id="@id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="100dip"
            android:layout_centerHorizontal="true"
            android:text="@string/clickMe" />
        
</RelativeLayout>

    布局中，我们放入4个TextView。分别用来标记和显示服务请求的状态、识别内容。然后再放置一个按钮，用来启动识别服务。

    以下我们来看看activity中的调用代码：

package com.example.testyuyinoffline;

import android.app.Activity;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.telephony.TelephonyManager;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;

import com.sogou.speech.offlinelistener.OutsideCallListener;
import com.sogou.speech.offlineutility.CoreControl;

public class MainActivity extends Activity {

	public static final String MSG_TEXT = "MSG_TEXT";
	CoreControl coreControl;
	TextView statusTextTView;
	TextView toSayTextTvTextView;
	
	Runnable regThread = new Runnable() {

		@Override
		public void run() {
			coreControl.startListening();
		}
	};

	Handler handler = new Handler() {
		@Override
		public void handleMessage(android.os.Message msg) {
			System.out.println("what=" + msg.what);
			switch (msg.what) {
			// 1.開始识别
			case 0x1:
				statusTextTView.setText("開始识别！
");
				break;
			// 2.认证成功
			case 0x2:
				statusTextTView.setText("认证成功。请说话！");
				break;
			// 3.录音结束
			case 0x3:
				statusTextTView.setText("录音结束！");
				break;
			// 4.说话内容
			case 0x4:
				String text = msg.getData().getString(MSG_TEXT);
				toSayTextTvTextView.setText(text);
				break;
			default:
				break;
			}
		}
	};

	@Override
	protected void onDestroy() {
		// TODO Auto-generated method stub
		super.onDestroy();

		if (coreControl != null) {
			coreControl.onDestroyService();
			System.out.println("断开语音service");
		}
	}

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		Button button = (Button) findViewById(R.id.button);
		statusTextTView = (TextView) findViewById(R.id.statusTextTv);
		toSayTextTvTextView = (TextView)findViewById(R.id.toSayTextTv);

		coreControl = new CoreControl(this.getApplicationContext(),
				(TelephonyManager) this.getSystemService(TELEPHONY_SERVICE),
				"<span style="background-color: rgb(255, 0, 0);">appId</span>", "<span style="background-color: rgb(255, 0, 0);">access-key</span>");

		coreControl.setmListener(new OutsideCallListener() {

			@Override
			public void onUpdateVolume(int arg0) {
				// TODO Auto-generated method stub

			}

			// 3.录音结束
			@Override
			public void onSpeechEnd() {
				// TODO Auto-generated method stub
				Bundle bundle = new Bundle();
				bundle.putString(MSG_TEXT, "录音结束");
				Message msg = handler.obtainMessage();
				msg.what = 0x3;
				msg.setData(bundle);
				msg.sendToTarget();

				System.out.println("3.录音结束");
			}

			@Override
			public void onServiceConnected(String arg0) {
				// TODO Auto-generated method stub

			}

			// 4.说话内容
			@Override
			public void onResults(String arg0, boolean arg1) {
				Bundle bundle = new Bundle();
				bundle.putString(MSG_TEXT, arg0);
				Message msg = handler.obtainMessage();
				msg.what = 0x4;
				msg.setData(bundle);
				msg.sendToTarget();

				System.out.println("4.说话内容：" + arg0);
			}

			// 1.開始识别
			@Override
			public void onRecognitionStart() {
				Bundle bundle = new Bundle();
				bundle.putString(MSG_TEXT, "開始识别！");
				Message msg = handler.obtainMessage();
				msg.what = 0x1;
				msg.setData(bundle);
				msg.sendToTarget();

				System.out.println("1.開始识别！
");
			}

			// 2.认证成功
			@Override
			public void onPassedValidation() {
				Bundle bundle = new Bundle();
				bundle.putString(MSG_TEXT, "认证成功！");
				Message msg = handler.obtainMessage();
				msg.what = 0x2;
				msg.setData(bundle);
				msg.sendToTarget();

				System.out.println("2.认证成功。请说话！");
			}

			@Override
			public void onFinishInit() {
				// TODO Auto-generated method stub

			}

			@Override
			public void onError(int arg0) {
				System.err.println("错误代码：" + arg0);
			}
		});

		coreControl.onInitializeService();

		button.setOnClickListener(new OnClickListener() {

			@Override
			public void onClick(View v) {
				if (coreControl != null) {
//					coreControl.startListening();
					handler.post(regThread);
				}
			}
		});

	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.main, menu);
		return true;
	}

	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		// Handle action bar item clicks here. The action bar will
		// automatically handle clicks on the Home/Up button, so long
		// as you specify a parent activity in AndroidManifest.xml.
		int id = item.getItemId();
		if (id == R.id.action_settings) {
			return true;
		}
		return super.onOptionsItemSelected(item);
	}
}

    注意将当中的“appId”和“access-key”换成你申请下来的信息值。

    我们的思路是，点击button的时候，启动语音识别服务；语音识别的不同状态过程中。将状态情况显示在界面上。识别出说话内容之后。将内容显示在界面上。

    在activity中，创建一个线程，线程开启识别服务。

    在程序创建的过程中。首先新建一个CoreControl对象。将程序环境信息、appId、access-key等传进去。然后给CoreControl对象设置OutsideCallListener监听。

监听中有几个比較重要的回调函数：

    1.開始识别 

public void onRecognitionStart()

    2.认证成功

public void onPassedValidation()

    3.录音结束

public void onSpeechEnd()

    4.得到说话内容

public void onResults(String arg0, boolean arg1)

    在这几个回调函数中。均使用handler向主线程传递状态參数。主线程的handler在其：

public void handleMessage(android.os.Message msg)

    这个函数中更改界面状态，并将识别内容显示出来。当退出App时，调用onDestroyService()方法断开与Service的连接：

protected void onDestroy()

    在出现异常的回调函数中：

public void onError(int arg0)

    能够错误码打印到后台或返回到前端，以便分析错误种类。错误码定义：

    

    非常easy不是吗！

3.3 client使用

    启动后界面：

    

    点击“我要说话”：

    

    对着麦克风说话后：

    

    更具体的内容能够參考搜狗的演示样例程序及SDK文档。

赶快试一试吧！