53 lines
3.1 KiB
HTML
53 lines
3.1 KiB
HTML
<p>This is a demo application highlighting how to make internet-based calls with
|
|
the SIP API. The application uses a walkie-talkie style interface, allowing you
|
|
to only be heard when the button is pushed down.</p>
|
|
|
|
<p>The source code for this demo app shows how to accomplish three key things
|
|
with SIP: Make a call, receive a call, and signal to the Android platform that
|
|
your app wants to receive incoming SIP calls, so that they can be handled from
|
|
within the application.</p>
|
|
|
|
|
|
<p>The application includes:<p>
|
|
<ul> <li><a
|
|
href="src/com/example/android/sip/SipSettings.html"><code>SipSettings</code></a>
|
|
— a <code>PreferenceActivity</code> that supplies basic settings for SIP
|
|
authentication.</li> <li><a
|
|
href="src/com/example/android/sip/IncomingCallReceiver.html"><code>
|
|
IncomingCallReceiver</code></a> — a <code>BroadcastReceiver</code>
|
|
that listens for incoming SIP calls and passes them to
|
|
<code>WalkieTalkieActivity</code> for handling.</li> <li><a
|
|
href="src/com/example/android/sip/WalkieTalkieActivity.html"><code>WalkieTalkieActivity</code></a>
|
|
— a activity that login to SIP provider and registers the device to
|
|
receive incoming SIP, handles incoming calls and makes outgoing calls, managing
|
|
UI during the call.</li> </ul>
|
|
<p>If you are developing an application that uses the SIP API, remember that the
|
|
feature is supported only on Android 2.3 (API level 9) and higher versions of
|
|
the platform. Also, among devices running Android 2.3 (API level 9) or higher,
|
|
not all devices will offer SIP support. To ensure that your application can only
|
|
be installed on devices that are capable of supporting SIP, remember to add the
|
|
following to the application's manifest before publishing to Google Play:</p>
|
|
<ul> <li><code><uses-sdk android:minSdkVersion="9" /></code>, which
|
|
indicates to Google Play and the platform that your application requires
|
|
Android 2.3 or higher. For more information, see <a
|
|
href="../../../guide/appendix/api-levels.html">API Levels</a> and the
|
|
documentation for the <a
|
|
href="../../../guide/topics/manifest/uses-sdk-element.html"><code><uses-sdk></code></a>
|
|
element.</li> </ul> <p>To control how Google Play filters your application
|
|
from devices that do not support SIP, remember to add the following to the
|
|
application's manifest <ul> <li><code><uses-feature
|
|
android:name="android.hardware.sip.voip" /></code>, which tells Google
|
|
Play that your application uses the SIP API. The declaration should include
|
|
an <code>android:required</code> attribute that indicates whether you want
|
|
Google Play to filter the application from devices that do not offer SIP
|
|
support. Other <code><uses-feature></code> declarations may also be
|
|
needed, depending on your implementation. For more information, see the
|
|
documentation for the <a
|
|
href="../../../guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a>
|
|
element.</li> </ul>
|
|
<p>For more information about using the SIP API, see the <a
|
|
href="../../../reference/android/net/sip/package-summary.html"><code>android.net.sip</a></code>
|
|
documentation. </p>
|
|
|
|
<img alt="" src="../images/SipDemo.png" />
|