拨打音频电话

要拨打音频呼叫，就必须具备以下条件：

1. 一个用于拨号的SipProfile对象（本地配置），一个接收呼叫的有效的SIP地址（对等配置）。

2. 一个SipManager对象。

你应该建立一个SipAudioCall.Listener来进行音频呼叫。跟SIP协议栈的大多数客户交互都是通过这个监听器来发生的。在下面的代码中，你会看到在建立呼叫之后，SipAudioCall.Listener是如何工作的：

SipAudioCall.Listener listener = new SipAudioCall.Listener() {
   @Override
   public void onCallEstablished(SipAudioCall call) {
      call.startAudio();
      call.setSpeakerMode(true);
      call.toggleMute();
     
   }
   
   @Override
   public void onCallEnded(SipAudioCall call) {
      // Do something.
   }
};

一旦你建立了SipAudioCall.Listener，你就可以呼叫了。SipManager对象的makeAudioCall方法需要以下参数：

1.  一个本地的SIP配置（呼叫者）；

2. 一个对等的SIP配置（被呼叫的用户）；

3. 一个SipAudioCall.Listener监听器，用于监听来自SipAudioCall的呼叫事件。这个监听器可以是null，但是如上述代码所示，一旦建立了呼叫，这个监听器就被用于做一些事情。

4. 超时值，以秒为单位。

例如：

call = mSipManager.makeAudioCall(mSipProfile.getUriString(), sipAddress, listener,30);

接收呼叫

SIP应用程序必须包含一个BroadcastReceiver类的子类来接收呼叫，这个类具有响应指明呼叫源的Intent对象的能力。因此，你的应用程序要做以下事情：

1. 在AndroidManifest.xml中声明一个<receiver>元素。在SipDemo中的声明是：<receiver android:name=".IncomingCallReceiver" android:label="Call Receiver"/>.

2. 实现该接收器，它是BroadcastReceiver的一个子类。在SipDemo中，这个类是IncomingCallReceiver。

3. 用呼叫本地配置文件时，触发你的接收器的PendingIntent对象来初始化本地的配置对象（SipProfile）。

4. 建立一个Intent过滤器来过滤代表呼入的操作。在SipDemo中，这个操作是android.SipDemo.INCOMING_CALL。

BroadcastReceiver的子类

要接收呼叫，你的SIP应用程序就必须实现一个BroadcastReceiver的子类。Android系统处理SIP的呼入，并且在收到呼入的时候广播一个“incoming call”的Intent对象（由应用程序定义的）。以下是来自SipDemo的BroadcastReceiver的子类的代码。要看完整的例子，请看SipDemo sample，它包含在SDK的示例中。

/*** Listens for incoming SIP calls, intercepts and hands them off to WalkieTalkieActivity.
 */
public class IncomingCallReceiver extends BroadcastReceiver {
    /**
     * Processes the incoming call, answers it, and hands it over to the
     * WalkieTalkieActivity.
     * @param context The context under which the receiver is running.
     * @param intent The intent being received.
     */
    @Override
    public void onReceive(Context context, Intent intent) {
        SipAudioCall incomingCall = null;
        try {
            SipAudioCall.Listener listener = new SipAudioCall.Listener() {
         
                public void onRinging(SipAudioCall call, SipProfile caller) {
                    try {
                        call.answerCall(30);
                    } catch (Exception e) {
                        e.printStackTrace();
 
                }
            };
            WalkieTalkieActivity wtActivity = (WalkieTalkieActivity) context;
            incomingCall = wtActivity.mSipManager.takeAudioCall(intent, listener);
            incomingCall.answerCall(30);
            incomingCall.startAudio();
            incomingCall.setSpeakerMode(true);
            if(incomingCall.isMuted()) {
                incomingCall.toggleMute();
            }
            wtActivity.call = incomingCall;
            wtActivity.updateStatus(incomingCall);
        } catch (Exception e) {
            if (incomingCall != null) {
                incomingCall.close();
            }
        }
    }
}

建立接收呼叫的Intent过滤器

当SIP服务接到一个新的呼叫的时候，它会发出一个带有由应用程序提供的操作字符串的Intent对象。在SipDemo中，这个操作字符串是android.SipDemo.INCOMING_CALL。

以下来自SipDemo的代码摘要显示了如果用基于操作字符串android.SipDemo.INCOMING_CALL所获得的PendingIntent对象来创建SipProfile对象。PendingIntent对象会在SipProfile对象接收一个呼叫时执行一个广播处理：

public SipManager mSipManager = null;
public SipProfile mSipProfile = null;
...
 
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);

该广播会被Intent过滤器截获，然后触发接收器（IncomingCallReceiver）。你可以在你的应用程序清单文件中指定一个Intent过滤器，或者是像SipDemo示例那样在应用程序的Activity的onCreate()方法中用代码来做这件事：

public class WalkieTalkieActivity extends Activity implements View.OnTouchListener {
...
    public IncomingCallReceiver callReceiver;
    ...
    @Override
    public void onCreate(Bundle savedInstanceState) { 
       IntentFilter filter = new IntentFilter();
       filter.addAction("android.SipDemo.INCOMING_CALL");
       callReceiver = new IncomingCallReceiver();
       this.registerReceiver(callReceiver, filter);
       ...
    }
    ...
}

测试SIP应用程序

按照以下步骤来测试SIP应用程序

1. 一部运行Android2.3以上系统的移动设备。SIP是运行在无线之上的，因此你必须在实际的设备上测试，在AVD上不能进行测试工作。

2. 一个SIP账号。有很多不同的SIP提供商会提供SIP账号。

3. 如果你要进行呼叫，就必须有一个有效的SIP账号。

测试SIP应用程序：

1. 在你的设备上，接入无线（Setting->Wireless&networks->Wi-Fi->Wi-Fi settings）

2. 把你的移动设备设置为用于调试，设置方法在Developing on a Device中进行了介绍。

3. 在你的移动设备上运行你的应用程序，运行方法在Developing on a Device中进行了介绍。

4. 如果你使用的是Eclipse，你可以使用Eclipse中LogCat来查看应用程序的日志输出（Window->Show View->Other->Android->LogCat）。