init

2020-04-04 17:19:13 +02:00
parent 2cb0a7449a
commit f36bfab5aa
78 changed files with 4370 additions and 0 deletions
--- a/docs/client_html/ar01s14.html
+++ b/docs/client_html/ar01s14.html
@@ -0,0 +1,3 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Sound codecs</title><link rel="stylesheet" href="ts3doc.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="index.html" title="TeamSpeak 3 Client SDK Developer Manual"><link rel="up" href="index.html" title="TeamSpeak 3 Client SDK Developer Manual"><link rel="prev" href="ar01s13s06.html" title="Activating the capture device"><link rel="next" href="ar01s15.html" title="Encoder options"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><img id="logo" src="images/logo.png"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Sound codecs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s13s06.html"><img src="images/prev.png" alt="Prev"></a><EFBFBD></td><th width="60%" align="center"><EFBFBD></th><td width="20%" align="right"><EFBFBD><a accesskey="n" href="ar01s15.html"><img src="images/next.png" alt="Next"></a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="codecs"></a>Sound codecs</h2></div></div></div><p>TeamSpeak 3 supports the following sound sampling rates<a class="indexterm" name="idm44835434543488"></a><a class="indexterm" name="idm44835434543072"></a>:</p><div class="itemizedlist"><ul type="disc"><li><p>Speex Narrowband (8 kHz)</p></li><li><p>Speex Wideband (16 kHz)</p></li><li><p>Speex Ultra-Wideband (32 kHz)</p></li><li><p>Celt (Mono, 48kHz)</p></li><li><p>Opus Voice (Mono, 48khz)</p></li><li><p>Opus Music (Stereo, 48khz)</p></li></ul></div><a class="indexterm" name="idm44835434538688"></a><a class="indexterm" name="idm44835434538144"></a><a class="indexterm" name="idm44835434537600"></a><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>Opus Voice is recommended for voice transmission. Speex and Celt codecs may be removed in future versions of this SDK.</p></td></tr></table></div><div class="literallayout"><p><br>
+</p></div><p>Bandwidth usage generally depends on the used codec and the <a class="link" href="ar01s15.html" title="Encoder options">encoders</a> quality setting.</p><p>Estimated bitrates (bps) for codecs per quality:</p><div class="informaltable"><table cellspacing="0" cellpadding="8" border="1"><colgroup><col><col><col><col><col><col><col></colgroup><thead><tr><th align="center">Quality</th><th align="center">Narrowband</th><th align="center">Wideband</th><th align="center">Ultra-Wideband</th><th align="center">Celt</th><th align="center">Opus Voice</th><th align="center">Opus Music</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">2,150</td><td align="center">3,950</td><td align="center">4,150</td><td align="center">32,000</td><td align="center">4,096</td><td align="center">7,200</td></tr><tr><td align="center">1</td><td align="center">3,950</td><td align="center">5,750</td><td align="center">7,550</td><td align="center">32,000</td><td align="center">8,192</td><td align="center">14,400</td></tr><tr><td align="center">2</td><td align="center">5,950</td><td align="center">7,750</td><td align="center">9,550</td><td align="center">40,000</td><td align="center">12,288</td><td align="center">21,600</td></tr><tr><td align="center">3</td><td align="center">8,000</td><td align="center">9,800</td><td align="center">11,600</td><td align="center">40,000</td><td align="center">16,384</td><td align="center">28,800</td></tr><tr><td align="center">4</td><td align="center">8,000</td><td align="center">12,800</td><td align="center">14,600</td><td align="center">40,000</td><td align="center">20,480</td><td align="center">36,000</td></tr><tr><td align="center">5</td><td align="center">11,000</td><td align="center">16,800</td><td align="center">18,600</td><td align="center">48,000</td><td align="center">24,576</td><td align="center">43,200</td></tr><tr><td align="center">6</td><td align="center">11,000</td><td align="center">20,600</td><td align="center">22,400</td><td align="center">48,000</td><td align="center">28,672</td><td align="center">50,400</td></tr><tr><td align="center">7</td><td align="center">15,000</td><td align="center">23,800</td><td align="center">25,600</td><td align="center">48,000</td><td align="center">32,768</td><td align="center">57,600</td></tr><tr><td align="center">8</td><td align="center">15,000</td><td align="center">27,800</td><td align="center">29,600</td><td align="center">48,000</td><td align="center">36,864</td><td align="center">64,800</td></tr><tr><td align="center">9</td><td align="center">18,200</td><td align="center">34,400</td><td align="center">36,200</td><td align="center">64,000</td><td align="center">40,960</td><td align="center">72,000</td></tr><tr><td align="center">10</td><td align="center">24,600</td><td align="center">42,400</td><td align="center">44,200</td><td align="center">96,000</td><td align="center">45,056</td><td align="center">79,200</td></tr></tbody></table></div><a class="indexterm" name="idm44835434472128"></a><p>Change the quality to find a good middle between voice quality and bandwidth usage. Overall the Opus codec delivers the best quality per used bandwidth.</p><p>Users need to use the same codec when talking to each others. The smallest unit of participants using the same codec is a channel. Different channels on the same TeamSpeak 3 server can use different codecs. The channel codec should be customizable by the users to allow for flexibility concerning bandwidth vs. quality concerns.</p><p>The codec can be set or changed for a given channel using the function <a class="link" href="ar01s22s02.html#setchannelvarasint"><code class="function">ts3client_setChannelVariableAsInt</code></a> by passing <em class="structfield"><code>CHANNEL_CODEC</code></em> for the properties flag:</p><pre class="programlisting">ts3client_setChannelVariableAsInt(scHandlerID, channelID, CHANNEL_CODEC, codec);</pre><p>Available values for <em class="structfield"><code>CHANNEL_CODEC</code></em> are:
+</p><div class="itemizedlist"><ul type="disc"><li><p>0 - Speex Narrowband)</p></li><li><p>1 - Speex Wideband</p></li><li><p>2 - Speex Ultra-Wideband</p></li><li><p>3 - Celt</p></li><li><p>4 - Opus Voice</p></li><li><p>5 - Opus Music</p></li></ul></div><p>For details on using the function <code class="function">ts3client_setChannelVariableAsInt</code> see the appropriate section on <a class="link" href="ar01s22s02.html" title="Channel information">changing channel data</a>.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s13s06.html"><img src="images/prev.png" alt="Prev"></a><EFBFBD></td><td width="20%" align="center"><EFBFBD></td><td width="40%" align="right"><EFBFBD><a accesskey="n" href="ar01s15.html"><img src="images/next.png" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top">Activating the capture device<63></td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/home.png" alt="Home"></a></td><td width="40%" align="right" valign="top"><EFBFBD>Encoder options</td></tr></table></div></body></html>