Android的联通性---会话发起协议(SIP)（二）
创建清单
如果你正在开发一个使用SIP API的应用程序，那么一定要记住，该功能只在Android2.3（API Level 9）以后的版本上才被支持。还有，不是所有的运行Android2.3（API Level 9）以后版本的设备都提供对SIP的支持。
把下列权限添加到你的应用程序清单中，以便使用SIP
1. android.permission.USE_SIP
2. android.permission.INTERNET
3. 要确保你的应用程序只能被安装子提供SIP能力的设备上，就要在你的应用程序清单中添加<uses-sdk android:minSdkVersion=”9”>。这个声明指明你的应用程序要求Android2.3以上的版本。更多的信息请看API级别和<uses-sdk>元素相关的文档。
4. 要控制你的应用程序能够被那些不支持SIP的设备过滤掉（例如，在Google Play上），还要把下列声明添加到你的应用程序的清单中：
<uses-feature android:name=”android.hardware.sip.voip” />。这就声明了你的应用程序所使用的SIP API。这个声明应该包含一个android:required数据，用它来指示你是否希望你的应用程序被不提供SIP支持的设备过滤掉。其他的<uses-feature>声明也可能需要，这依赖与你的实现。更多的信息请看<uses-feature>元素的文档。
5. 如果你的应用程序被设计成要接收呼叫，你还必须在应用程序的清单中定义一个接收器（BroadcastReceiver类的子类）。
<receiver android:name=”.IncomingCallReceiver” android:label=”Call Receiver” />
以下是SipDemo示例清单中的摘要：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.android.sip">
...
<receiver android:name=".IncomingCallReceiver" android:label="Call Receiver"/>
...
<uses-sdk android:minSdkVersion="9" />
<uses-permission android:name="android.permission.USE_SIP" />
<uses-permission android:name="android.permission.INTERNET" />
...
<uses-feature android:name="android.hardware.sip.voip" android:required="true" />
<uses-feature android:name="android.hardware.wifi" android:required="true" />
<uses-feature android:name="android.hardware.microphone" android:required="true" />
</manifest>
创建SipManager
要使用SIP API，你的应用程序就必须创建一个SipManager对象，在你的应用程序中，该对象负责以下工作：
1. 启动SIP会话；
2. 启动并接受呼叫；
3. 注册和注销SIP服务提供商；
4. 验证会话的联通性。
用下列方式实例化一个新的SipManager对象：
public SipManager mSipManager = null;
…
if(mSipManager == null) {
mSipManager = SipManager.newInstance(this);
}
注册SIP服务
典型的Android SIP应用程序要涉及到一个或多个用户，每个用户都要有一个SIP账号。在一个Android SIP应用程序中，每个SIP账号由一个SipProfile对象来代表。
一个SipProfile对象定义了一个SIP配置，包括：一个SIP账号、域名和服务器信息。跟运行应用程序的设备上的SIP账号相关联的配置（profile）被叫做本地配置（local profile）。用于连接会话的配置被叫做对等配置（peer profile）。当你的SIP应用程序使用本地的SipProfile对象登录到SIP服务器时，这实际上是用注册设备所用的SIP地址来发送SIP呼叫。
本段向你介绍如何创建SipProfile对象，注册SIP服务器、跟中注册事件。
以下是创建SipProfile对象的代码：
public SipProfile mSipProfile = null;
...
SipProfile.Builder builder = new SipProfile.Builder(username, domain);
builder.setPassword(password);
mSipProfile = builder.build();
以下代码判断会打开本地配置用于拨打电话和（或）接收通用的SIP呼叫。主叫方通过mSipManager.makeAudioCall()方法可以进行后续的呼叫。这段代码还设置了android.SipDemo.INCOMING_CALL操作，该操作会在设备接收到一个呼叫时，由Intent过滤器来使用，以下是注册的步骤：
Intent intent = new Intent();
intent.setAction("android.SipDemo.INCOMING_CALL");
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, Intent.FILL_IN_DATA);
mSipManager.open(mSipProfile, pendingIntent, null);
最后，这段代码把SipRegistrationListener监听器设置到SipManager对象上。这样就跟踪SipProfile对象是否成功的注册到了你SIP服务提供商那儿：
mSipManager.setRegistrationListener(mSipProfile.getUriString(), new SipRegistrationListener() {
public void onRegistering(String localProfileUri) {
updateStatus("Registering with SIP Server...");
}
public void onRegistrationDone(String localProfileUri, long expiryTime) {
updateStatus("Ready");
}
public void onRegistrationFailed(String localProfileUri, int errorCode,
String errorMessage) {
updateStatus("Registration failed. Please check settings.");
}
当你的应用程序完成对一个配置的使用时，它应该被关闭，以便释放跟这些对象关联的内存，并从服务器上注销该设备的连接，如：
public void closeLocalProfile() {
if (mSipManager == null) {
return;
}
try {
if (mSipProfile != null) {
mSipManager.close(mSipProfile.getUriString());
}
} catch (Exception ee) {
Log.d("WalkieTalkieActivity/onDestroy", "Failed to close local profile.", ee);
}
}