summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Main <smain@google.com>2011-05-05 18:04:28 -0700
committerAndroid Git Automerger <android-git-automerger@android.com>2011-05-05 18:04:28 -0700
commitb8df57d8767923f40bd52a0d2d1114e67fa76fa5 (patch)
tree508cbc6e93437356ac7ea6b14f9a7c434c0352bb
parent2d92d7791766e35ad6896a7a6a074d68008fe6dd (diff)
parentd81214dae45a4b38919296af41bf756e3931675a (diff)
downloadframeworks_base-b8df57d8767923f40bd52a0d2d1114e67fa76fa5.zip
frameworks_base-b8df57d8767923f40bd52a0d2d1114e67fa76fa5.tar.gz
frameworks_base-b8df57d8767923f40bd52a0d2d1114e67fa76fa5.tar.bz2
am d81214da: am a7a9c4cb: am 46524f83: Merge "docs: add package description for RTP" into honeycomb-mr1
* commit 'd81214dae45a4b38919296af41bf756e3931675a': docs: add package description for RTP
-rw-r--r--voip/java/android/net/rtp/package.html28
1 files changed, 28 insertions, 0 deletions
diff --git a/voip/java/android/net/rtp/package.html b/voip/java/android/net/rtp/package.html
new file mode 100644
index 0000000..4506b09
--- /dev/null
+++ b/voip/java/android/net/rtp/package.html
@@ -0,0 +1,28 @@
+<html>
+<body>
+<p>Provides APIs for RTP (Real-time Transport Protocol), allowing applications to manage on-demand
+or interactive data streaming. In particular, apps that provide VOIP, push-to-talk, conferencing,
+and audio streaming can use these APIs to initiate sessions and transmit or receive data streams
+over any available network.</p>
+
+<p>To support audio conferencing and similar usages, you need to instantiate two classes as
+endpoints for the stream:</p>
+
+<ul>
+<li>{@link android.net.rtp.AudioStream} specifies a remote endpoint and consists of network mapping
+and a configured {@link android.net.rtp.AudioCodec}.</li>
+
+<li>{@link android.net.rtp.AudioGroup} represents the local endpoint for one or more {@link
+android.net.rtp.AudioStream}s. The {@link android.net.rtp.AudioGroup} mixes all the {@link
+android.net.rtp.AudioStream}s and optionally interacts with the device speaker and the microphone at
+the same time.</li>
+</ul>
+
+<p>The simplest usage involves a single remote endpoint and local endpoint. For more complex usages,
+refer to the limitations described for {@link android.net.rtp.AudioGroup}.</p>
+
+<p class="note"><strong>Note:</strong> To use the RTP APIs, you must request the {@link
+android.Manifest.permission#INTERNET} and {@link
+android.Manifest.permission#RECORD_AUDIO} permissions in your manifest file.</p>
+</body>
+</html> \ No newline at end of file