index.html 75 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347
  1. <!doctype html>
  2. <html class="default no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  6. <title>@urtc/sdk-web</title>
  7. <meta name="description" content="Documentation for @urtc/sdk-web">
  8. <meta name="viewport" content="width=device-width, initial-scale=1">
  9. <link rel="stylesheet" href="assets/css/main.css">
  10. </head>
  11. <body>
  12. <header>
  13. <div class="tsd-page-toolbar">
  14. <div class="container">
  15. <div class="table-wrap">
  16. <div class="table-cell" id="tsd-search" data-index="assets/js/search.json" data-base=".">
  17. <div class="field">
  18. <label for="tsd-search-field" class="tsd-widget search no-caption">Search</label>
  19. <input id="tsd-search-field" type="text" />
  20. </div>
  21. <ul class="results">
  22. <li class="state loading">Preparing search index...</li>
  23. <li class="state failure">The search index is not available</li>
  24. </ul>
  25. <a href="index.html" class="title">@urtc/sdk-web</a>
  26. </div>
  27. <div class="table-cell" id="tsd-widgets">
  28. <div id="tsd-filter">
  29. <a href="#" class="tsd-widget options no-caption" data-toggle="options">Options</a>
  30. <div class="tsd-filter-group">
  31. <div class="tsd-select" id="tsd-filter-visibility">
  32. <span class="tsd-select-label">All</span>
  33. <ul class="tsd-select-list">
  34. <li data-value="public">Public</li>
  35. <li data-value="protected">Public/Protected</li>
  36. <li data-value="private" class="selected">All</li>
  37. </ul>
  38. </div>
  39. <input type="checkbox" id="tsd-filter-inherited" checked />
  40. <label class="tsd-widget" for="tsd-filter-inherited">Inherited</label>
  41. <input type="checkbox" id="tsd-filter-externals" checked />
  42. <label class="tsd-widget" for="tsd-filter-externals">Externals</label>
  43. </div>
  44. </div>
  45. <a href="#" class="tsd-widget menu no-caption" data-toggle="menu">Menu</a>
  46. </div>
  47. </div>
  48. </div>
  49. </div>
  50. <div class="tsd-page-title">
  51. <div class="container">
  52. <ul class="tsd-breadcrumb">
  53. <li>
  54. <a href="index.html">Globals</a>
  55. </li>
  56. </ul>
  57. <h1>@urtc/sdk-web</h1>
  58. </div>
  59. </div>
  60. </header>
  61. <div class="container container-main">
  62. <div class="row">
  63. <div class="col-8 col-content">
  64. <section class="tsd-panel-group tsd-index-group">
  65. <h2>Index</h2>
  66. <section class="tsd-panel tsd-index-panel">
  67. <div class="tsd-index-content">
  68. <section class="tsd-index-section tsd-is-external">
  69. <h3>Classes</h3>
  70. <ul class="tsd-index-list">
  71. <li class="tsd-kind-class tsd-is-external"><a href="classes/client.html" class="tsd-kind-icon">Client</a></li>
  72. <li class="tsd-kind-class tsd-is-external"><a href="classes/localstream.html" class="tsd-kind-icon">Local<wbr>Stream</a></li>
  73. <li class="tsd-kind-class tsd-is-external"><a href="classes/remotestream.html" class="tsd-kind-icon">Remote<wbr>Stream</a></li>
  74. <li class="tsd-kind-class tsd-is-external"><a href="classes/rtcerror.html" class="tsd-kind-icon">Rtc<wbr>Error</a></li>
  75. <li class="tsd-kind-class tsd-is-external"><a href="classes/stream.html" class="tsd-kind-icon">Stream</a></li>
  76. <li class="tsd-kind-class tsd-is-external"><a href="classes/user.html" class="tsd-kind-icon">User</a></li>
  77. </ul>
  78. </section>
  79. <section class="tsd-index-section tsd-is-external">
  80. <h3>Interfaces</h3>
  81. <ul class="tsd-index-list">
  82. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/audiostats.html" class="tsd-kind-icon">Audio<wbr>Stats</a></li>
  83. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/clientoptions.html" class="tsd-kind-icon">Client<wbr>Options</a></li>
  84. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/connectionstates.html" class="tsd-kind-icon">Connection<wbr>States</a></li>
  85. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/customvideoprofile.html" class="tsd-kind-icon">Custom<wbr>Video<wbr>Profile</a></li>
  86. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/devicedetectionoptions.html" class="tsd-kind-icon">Device<wbr>Detection<wbr>Options</a></li>
  87. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/joinoptions.html" class="tsd-kind-icon">Join<wbr>Options</a></li>
  88. <li class="tsd-kind-interface tsd-has-type-parameter tsd-is-external"><a href="interfaces/listener.html" class="tsd-kind-icon">Listener</a></li>
  89. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/localstreamoptions.html" class="tsd-kind-icon">Local<wbr>Stream<wbr>Options</a></li>
  90. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/networkstats.html" class="tsd-kind-icon">Network<wbr>Stats</a></li>
  91. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/playoptions.html" class="tsd-kind-icon">Play<wbr>Options</a></li>
  92. <li class="tsd-kind-interface tsd-has-type-parameter tsd-is-external"><a href="interfaces/rtcevent.html" class="tsd-kind-icon">Rtc<wbr>Event</a></li>
  93. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/serverconfig.html" class="tsd-kind-icon">Server<wbr>Config</a></li>
  94. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/streamplugin.html" class="tsd-kind-icon">Stream<wbr>Plugin</a></li>
  95. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/streamstats.html" class="tsd-kind-icon">Stream<wbr>Stats</a></li>
  96. <li class="tsd-kind-interface tsd-is-external"><a href="interfaces/videostats.html" class="tsd-kind-icon">Video<wbr>Stats</a></li>
  97. </ul>
  98. </section>
  99. <section class="tsd-index-section tsd-is-external">
  100. <h3>Type aliases</h3>
  101. <ul class="tsd-index-list">
  102. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#audiocodec" class="tsd-kind-icon">Audio<wbr>Codec</a></li>
  103. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#connectionstate" class="tsd-kind-icon">Connection<wbr>State</a></li>
  104. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#errorcode" class="tsd-kind-icon">Error<wbr>Code</a></li>
  105. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#loglevel" class="tsd-kind-icon">Log<wbr>Level</a></li>
  106. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#mediatype" class="tsd-kind-icon">Media<wbr>Type</a></li>
  107. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#playervideofittype" class="tsd-kind-icon">Player<wbr>Video<wbr>Fit<wbr>Type</a></li>
  108. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#roletype" class="tsd-kind-icon">Role<wbr>Type</a></li>
  109. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#roomtype" class="tsd-kind-icon">Room<wbr>Type</a></li>
  110. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcconnectionevent" class="tsd-kind-icon">Rtc<wbr>Connection<wbr>Event</a></li>
  111. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcconnectioneventtype" class="tsd-kind-icon">Rtc<wbr>Connection<wbr>Event<wbr>Type</a></li>
  112. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtceventtype" class="tsd-kind-icon">Rtc<wbr>Event<wbr>Type</a></li>
  113. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcstreamevent" class="tsd-kind-icon">Rtc<wbr>Stream<wbr>Event</a></li>
  114. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcstreameventtype" class="tsd-kind-icon">Rtc<wbr>Stream<wbr>Event<wbr>Type</a></li>
  115. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcuserevent" class="tsd-kind-icon">Rtc<wbr>User<wbr>Event</a></li>
  116. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#rtcusereventtype" class="tsd-kind-icon">Rtc<wbr>User<wbr>Event<wbr>Type</a></li>
  117. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#screenprofile" class="tsd-kind-icon">Screen<wbr>Profile</a></li>
  118. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#switchdevicetype" class="tsd-kind-icon">Switch<wbr>Device<wbr>Type</a></li>
  119. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#videocodec" class="tsd-kind-icon">Video<wbr>Codec</a></li>
  120. <li class="tsd-kind-type-alias tsd-is-external"><a href="index.html#videoprofile" class="tsd-kind-icon">Video<wbr>Profile</a></li>
  121. </ul>
  122. </section>
  123. <section class="tsd-index-section tsd-is-external">
  124. <h3>Variables</h3>
  125. <ul class="tsd-index-list">
  126. <li class="tsd-kind-variable tsd-is-external"><a href="index.html#version" class="tsd-kind-icon">version</a></li>
  127. </ul>
  128. </section>
  129. <section class="tsd-index-section ">
  130. <h3>Functions</h3>
  131. <ul class="tsd-index-list">
  132. <li class="tsd-kind-function"><a href="index.html#createclient" class="tsd-kind-icon">create<wbr>Client</a></li>
  133. <li class="tsd-kind-function"><a href="index.html#createstream" class="tsd-kind-icon">create<wbr>Stream</a></li>
  134. <li class="tsd-kind-function tsd-is-external"><a href="index.html#devicedetection" class="tsd-kind-icon">device<wbr>Detection</a></li>
  135. <li class="tsd-kind-function tsd-is-external"><a href="index.html#generatetoken" class="tsd-kind-icon">generate<wbr>Token</a></li>
  136. <li class="tsd-kind-function tsd-is-external"><a href="index.html#getcameras" class="tsd-kind-icon">get<wbr>Cameras</a></li>
  137. <li class="tsd-kind-function tsd-is-external"><a href="index.html#getdevices" class="tsd-kind-icon">get<wbr>Devices</a></li>
  138. <li class="tsd-kind-function tsd-is-external"><a href="index.html#getloudspeakers" class="tsd-kind-icon">get<wbr>Loudspeakers</a></li>
  139. <li class="tsd-kind-function tsd-is-external"><a href="index.html#getmicrophones" class="tsd-kind-icon">get<wbr>Microphones</a></li>
  140. <li class="tsd-kind-function tsd-is-external"><a href="index.html#issupportscreenshare" class="tsd-kind-icon">is<wbr>Support<wbr>Screen<wbr>Share</a></li>
  141. <li class="tsd-kind-function tsd-is-external"><a href="index.html#issupportwebrtc" class="tsd-kind-icon">is<wbr>Support<wbr>WebRTC</a></li>
  142. <li class="tsd-kind-function"><a href="index.html#reportlog" class="tsd-kind-icon">report<wbr>Log</a></li>
  143. <li class="tsd-kind-function"><a href="index.html#setloglevel" class="tsd-kind-icon">set<wbr>Log<wbr>Level</a></li>
  144. <li class="tsd-kind-function tsd-is-external"><a href="index.html#setservers" class="tsd-kind-icon">set<wbr>Servers</a></li>
  145. </ul>
  146. </section>
  147. </div>
  148. </section>
  149. </section>
  150. <section class="tsd-panel-group tsd-member-group tsd-is-external">
  151. <h2>Type aliases</h2>
  152. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  153. <a name="audiocodec" class="tsd-anchor"></a>
  154. <h3>Audio<wbr>Codec</h3>
  155. <div class="tsd-signature tsd-kind-icon">Audio<wbr>Codec<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"opus"</span></div>
  156. <aside class="tsd-sources">
  157. </aside>
  158. <div class="tsd-comment tsd-typography">
  159. <div class="lead">
  160. <p>音频编解码格式</p>
  161. </div>
  162. </div>
  163. </section>
  164. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  165. <a name="connectionstate" class="tsd-anchor"></a>
  166. <h3>Connection<wbr>State</h3>
  167. <div class="tsd-signature tsd-kind-icon">Connection<wbr>State<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"OPEN"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"CONNECTING"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"CLOSING"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"RECONNECTING"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"CLOSED"</span></div>
  168. <aside class="tsd-sources">
  169. </aside>
  170. <div class="tsd-comment tsd-typography">
  171. <div class="lead">
  172. <p>连接状态类型:</p>
  173. <ul>
  174. <li>OPEN - 已连接</li>
  175. <li>CONNECTING - 连接中</li>
  176. <li>CLOSING - 断开中</li>
  177. <li>RECONNECTING - 重连中</li>
  178. <li>CLOSED - 已断开</li>
  179. </ul>
  180. </div>
  181. </div>
  182. </section>
  183. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  184. <a name="errorcode" class="tsd-anchor"></a>
  185. <h3>Error<wbr>Code</h3>
  186. <div class="tsd-signature tsd-kind-icon">Error<wbr>Code<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">typeof </span><span class="tsd-signature-type">RtcError</span><span class="tsd-signature-symbol">[</span><span class="tsd-signature-type">Exclude</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-symbol">keyof </span><span class="tsd-signature-symbol">typeof </span><span class="tsd-signature-type">RtcError</span><span class="tsd-signature-symbol">, </span><span class="tsd-signature-type">"prototype"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"getCode"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"stackTraceLimit"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"prepareStackTrace"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"captureStackTrace"</span><span class="tsd-signature-symbol">&gt;</span><span class="tsd-signature-symbol">]</span></div>
  187. <aside class="tsd-sources">
  188. </aside>
  189. <div class="tsd-comment tsd-typography">
  190. <div class="lead">
  191. <p>URTC 错误代码</p>
  192. </div>
  193. <p>通用错误及代码</p>
  194. <ul>
  195. <li>1000 - 非法参数</li>
  196. <li>1001 - 非法操作</li>
  197. <li>1002 - 不支持</li>
  198. <li>1003 - 不存在</li>
  199. <li>1004 - 请求失败</li>
  200. <li>1999 - 其他错误</li>
  201. </ul>
  202. <p>房间相关错误及代码</p>
  203. <ul>
  204. <li>2000 - 网关不可达</li>
  205. <li>2001 - 获取 Access Token 失败</li>
  206. <li>2002 - Access Token 非法</li>
  207. <li>2003 - Websocket 连接失败</li>
  208. <li>2004 - 加入房间失败</li>
  209. <li>2005 - 未加入房间</li>
  210. <li>2006 - 正在加入房间</li>
  211. <li>2007 - 正在离开房间</li>
  212. <li>2008 - 角色类型不匹配</li>
  213. <li>2009 - 信令服务器地址错误</li>
  214. </ul>
  215. <p>流相关错误及代码</p>
  216. <ul>
  217. <li>3000 - 流不存在</li>
  218. <li>3001 - 同类型的流已存在</li>
  219. <li>3002 - 音频不存在</li>
  220. <li>3003 - 视频不存在</li>
  221. <li>3004 - [中止错误] 尽管用户和操作系统都授予了访问设备硬件的权利,而且未出现可能抛出NotReadableError异常的硬件问题,但仍然有一些问题的出现导致了设备无法被使用。</li>
  222. <li>3005 - [拒绝错误] 用户拒绝了当前的浏览器实例的访问请求;或者用户拒绝了当前会话的访问;或者用户在全局范围内拒绝了所有媒体访问请求。</li>
  223. <li>3006 - [找不到错误] 找不到满足请求参数的媒体类型。</li>
  224. <li>3007 - [无法读取错误] 尽管用户已经授权使用相应的设备,操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问。</li>
  225. <li>3008 - [无法满足要求错误] 指定的要求无法被设备满足。</li>
  226. <li>3009 - 流连接失败</li>
  227. <li>3010 - 流正在重连</li>
  228. <li>3011 - 流尚未发布</li>
  229. <li>3012 - 流正在发布</li>
  230. <li>3013 - 流正在取消发布</li>
  231. <li>3014 - 流已经发布</li>
  232. <li>3015 - 流尚未订阅</li>
  233. <li>3016 - 流正在订阅</li>
  234. <li>3017 - 流正在取消订阅</li>
  235. <li>3018 - 流已经订阅</li>
  236. <li>3019 - 自动播放被禁止错误</li>
  237. </ul>
  238. </div>
  239. </section>
  240. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  241. <a name="loglevel" class="tsd-anchor"></a>
  242. <h3>Log<wbr>Level</h3>
  243. <div class="tsd-signature tsd-kind-icon">Log<wbr>Level<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"debug"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"info"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"warn"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"error"</span></div>
  244. <aside class="tsd-sources">
  245. </aside>
  246. <div class="tsd-comment tsd-typography">
  247. <div class="lead">
  248. <p>日志级别</p>
  249. </div>
  250. </div>
  251. </section>
  252. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  253. <a name="mediatype" class="tsd-anchor"></a>
  254. <h3>Media<wbr>Type</h3>
  255. <div class="tsd-signature tsd-kind-icon">Media<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"main"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"auxiliary"</span></div>
  256. <aside class="tsd-sources">
  257. </aside>
  258. <div class="tsd-comment tsd-typography">
  259. <div class="lead">
  260. <p>流的媒体类型, main - 主视频流,auxiliary - 辅助视频流,通常是一个屏幕分享流</p>
  261. </div>
  262. </div>
  263. </section>
  264. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  265. <a name="playervideofittype" class="tsd-anchor"></a>
  266. <h3>Player<wbr>Video<wbr>Fit<wbr>Type</h3>
  267. <div class="tsd-signature tsd-kind-icon">Player<wbr>Video<wbr>Fit<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"cover"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"contain"</span></div>
  268. <aside class="tsd-sources">
  269. </aside>
  270. <div class="tsd-comment tsd-typography">
  271. <div class="lead">
  272. <p>视频播放时的显示模式</p>
  273. <ul>
  274. <li>cover 模式:优先保证视窗被填满。</li>
  275. <li>contain 模式:优先保证视频内容全部显示。
  276. 播放摄像头视频流默认使用 cover 模式,屏幕共享视频流默认使用 contain 模式。</li>
  277. </ul>
  278. </div>
  279. </div>
  280. </section>
  281. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  282. <a name="roletype" class="tsd-anchor"></a>
  283. <h3>Role<wbr>Type</h3>
  284. <div class="tsd-signature tsd-kind-icon">Role<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"pull"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"push"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"push-and-pull"</span></div>
  285. <aside class="tsd-sources">
  286. </aside>
  287. <div class="tsd-comment tsd-typography">
  288. <div class="lead">
  289. <p>用户角色</p>
  290. </div>
  291. </div>
  292. </section>
  293. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  294. <a name="roomtype" class="tsd-anchor"></a>
  295. <h3>Room<wbr>Type</h3>
  296. <div class="tsd-signature tsd-kind-icon">Room<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"rtc"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"live"</span></div>
  297. <aside class="tsd-sources">
  298. </aside>
  299. <div class="tsd-comment tsd-typography">
  300. <div class="lead">
  301. <p>房间类型</p>
  302. </div>
  303. </div>
  304. </section>
  305. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  306. <a name="rtcconnectionevent" class="tsd-anchor"></a>
  307. <h3>Rtc<wbr>Connection<wbr>Event</h3>
  308. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>Connection<wbr>Event<span class="tsd-signature-symbol">:</span> <a href="interfaces/rtcevent.html" class="tsd-signature-type">RtcEvent</a><span class="tsd-signature-symbol">&lt;</span><a href="index.html#rtcconnectioneventtype" class="tsd-signature-type">RtcConnectionEventType</a><span class="tsd-signature-symbol">, </span><a href="interfaces/connectionstates.html" class="tsd-signature-type">ConnectionStates</a><span class="tsd-signature-symbol">&gt;</span></div>
  309. <aside class="tsd-sources">
  310. </aside>
  311. <div class="tsd-comment tsd-typography">
  312. <div class="lead">
  313. <p>Rtc 连接事件,事件类型参见 <a href="index.html#rtcconnectioneventtype">RtcConnectionEventType</a></p>
  314. </div>
  315. </div>
  316. </section>
  317. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  318. <a name="rtcconnectioneventtype" class="tsd-anchor"></a>
  319. <h3>Rtc<wbr>Connection<wbr>Event<wbr>Type</h3>
  320. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>Connection<wbr>Event<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"connection-state-changed"</span></div>
  321. <aside class="tsd-sources">
  322. </aside>
  323. <div class="tsd-comment tsd-typography">
  324. <div class="lead">
  325. <p>Rtc 客户端连接事件类型:</p>
  326. </div>
  327. <p><a href="index.html#rtcconnectionevent">连接事件</a></p>
  328. <ul>
  329. <li>connection-state-changed - 连接状态改变</li>
  330. </ul>
  331. <dl class="tsd-comment-tags">
  332. <dt>example</dt>
  333. <dd><pre><code class="language-js">client.on(<span class="hljs-string">&#x27;connection-state-changed&#x27;</span>, <span class="hljs-function">(<span class="hljs-params">event</span>) =&gt;</span> {
  334. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`连接状态:<span class="hljs-subst">${event.data.previous}</span> =&gt; <span class="hljs-subst">${event.data.current}</span>`</span>);
  335. });</code></pre>
  336. </dd>
  337. </dl>
  338. </div>
  339. </section>
  340. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  341. <a name="rtceventtype" class="tsd-anchor"></a>
  342. <h3>Rtc<wbr>Event<wbr>Type</h3>
  343. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>Event<wbr>Type<span class="tsd-signature-symbol">:</span> <a href="index.html#rtcusereventtype" class="tsd-signature-type">RtcUserEventType</a><span class="tsd-signature-symbol"> | </span><a href="index.html#rtcstreameventtype" class="tsd-signature-type">RtcStreamEventType</a><span class="tsd-signature-symbol"> | </span><a href="index.html#rtcconnectioneventtype" class="tsd-signature-type">RtcConnectionEventType</a></div>
  344. <aside class="tsd-sources">
  345. </aside>
  346. <div class="tsd-comment tsd-typography">
  347. <div class="lead">
  348. <p>Rtc 事件类型</p>
  349. </div>
  350. </div>
  351. </section>
  352. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  353. <a name="rtcstreamevent" class="tsd-anchor"></a>
  354. <h3>Rtc<wbr>Stream<wbr>Event</h3>
  355. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>Stream<wbr>Event<span class="tsd-signature-symbol">:</span> <a href="interfaces/rtcevent.html" class="tsd-signature-type">RtcEvent</a><span class="tsd-signature-symbol">&lt;</span><a href="index.html#rtcstreameventtype" class="tsd-signature-type">RtcStreamEventType</a><span class="tsd-signature-symbol">, </span><a href="classes/stream.html" class="tsd-signature-type">Stream</a><span class="tsd-signature-symbol"> | </span><a href="classes/localstream.html" class="tsd-signature-type">LocalStream</a><span class="tsd-signature-symbol"> | </span><a href="classes/remotestream.html" class="tsd-signature-type">RemoteStream</a><span class="tsd-signature-symbol">&gt;</span></div>
  356. <aside class="tsd-sources">
  357. </aside>
  358. <div class="tsd-comment tsd-typography">
  359. <div class="lead">
  360. <p>Rtc 流事件,事件类型参见 <a href="index.html#rtcstreameventtype">RtcStreamEventType</a></p>
  361. </div>
  362. </div>
  363. </section>
  364. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  365. <a name="rtcstreameventtype" class="tsd-anchor"></a>
  366. <h3>Rtc<wbr>Stream<wbr>Event<wbr>Type</h3>
  367. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>Stream<wbr>Event<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"stream-added"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"stream-removed"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"stream-subscribed"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"stream-published"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"mute-audio"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"unmute-audio"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"mute-video"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"unmute-video"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"first-key-frame"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"screenshare-stopped"</span></div>
  368. <aside class="tsd-sources">
  369. </aside>
  370. <div class="tsd-comment tsd-typography">
  371. <div class="lead">
  372. <p>Rtc 流事件类型:</p>
  373. </div>
  374. <p><a href="index.html#rtcstreamevent">流事件</a></p>
  375. <ul>
  376. <li>stream-added - 有远端流加入,此时事件中的 data 为 <a href="classes/remotestream.html">RemoteStream</a> 远端流</li>
  377. <li>stream-removed - 有远端流移除,此时事件中的 data 为 <a href="classes/remotestream.html">RemoteStream</a> 远端流</li>
  378. <li>stream-subscribed - 远端流订阅完成,此时事件中的 data 为 <a href="classes/remotestream.html">RemoteStream</a> 远端流</li>
  379. <li>stream-published - 本地流发布完成,此时事件中的 data 为 <a href="classes/localstream.html">LocalStream</a> 本地流</li>
  380. <li>mute-audio - 流的音频被 mute</li>
  381. <li>unmute-audio - 流的音频被取消 mute</li>
  382. <li>mute-video - 流的视频被 mute</li>
  383. <li>unmute-video - 流的视频被取消 mute</li>
  384. <li>first-key-frame - 接收到远端流的首帧</li>
  385. </ul>
  386. <dl class="tsd-comment-tags">
  387. <dt>example</dt>
  388. <dd><pre><code class="language-js">client.on(<span class="hljs-string">&#x27;stream-add&#x27;</span>, <span class="hljs-function">(<span class="hljs-params">event</span>) =&gt;</span> {
  389. client.subscribe(event.data);
  390. });</code></pre>
  391. <p><strong>特别地,以下事件需在单条流上进行监听</strong></p>
  392. <ul>
  393. <li>screenshare-stopped - 屏幕共享流被中止,此时事件中的 data 为 <a href="classes/localstream.html">LocalStream</a> 本地流</li>
  394. </ul>
  395. </dd>
  396. <dt>example</dt>
  397. <dd><pre><code class="language-js">localStream.on(<span class="hljs-string">&#x27;screenshare-stopped&#x27;</span>, <span class="hljs-function">(<span class="hljs-params">event</span>) =&gt;</span> {
  398. client.unpublish(event.data);
  399. event.data.destroy();
  400. });</code></pre>
  401. </dd>
  402. </dl>
  403. </div>
  404. </section>
  405. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  406. <a name="rtcuserevent" class="tsd-anchor"></a>
  407. <h3>Rtc<wbr>User<wbr>Event</h3>
  408. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>User<wbr>Event<span class="tsd-signature-symbol">:</span> <a href="interfaces/rtcevent.html" class="tsd-signature-type">RtcEvent</a><span class="tsd-signature-symbol">&lt;</span><a href="index.html#rtcusereventtype" class="tsd-signature-type">RtcUserEventType</a><span class="tsd-signature-symbol">, </span><a href="classes/user.html" class="tsd-signature-type">User</a><span class="tsd-signature-symbol">&gt;</span></div>
  409. <aside class="tsd-sources">
  410. </aside>
  411. <div class="tsd-comment tsd-typography">
  412. <div class="lead">
  413. <p>Rtc 用户事件,事件类型参见 <a href="index.html#rtcusereventtype">RtcUserEventType</a></p>
  414. </div>
  415. </div>
  416. </section>
  417. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  418. <a name="rtcusereventtype" class="tsd-anchor"></a>
  419. <h3>Rtc<wbr>User<wbr>Event<wbr>Type</h3>
  420. <div class="tsd-signature tsd-kind-icon">Rtc<wbr>User<wbr>Event<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"user-joined"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"user-left"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"kick-off"</span></div>
  421. <aside class="tsd-sources">
  422. </aside>
  423. <div class="tsd-comment tsd-typography">
  424. <div class="lead">
  425. <p>Rtc 用户事件类型:</p>
  426. </div>
  427. <p><a href="index.html#rtcuserevent">用户事件</a></p>
  428. <ul>
  429. <li>user-joined - 有用户加入房间</li>
  430. <li>user-left - 有用户离开房间</li>
  431. <li>kick-off - 当前用户被踢出房间</li>
  432. </ul>
  433. <dl class="tsd-comment-tags">
  434. <dt>example</dt>
  435. <dd><pre><code class="language-js">client.on(<span class="hljs-string">&#x27;user-joined&#x27;</span>, <span class="hljs-function">(<span class="hljs-params">event</span>) =&gt;</span> {
  436. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`用户 <span class="hljs-subst">${event.data.id}</span> 加入`</span>);
  437. });</code></pre>
  438. </dd>
  439. </dl>
  440. </div>
  441. </section>
  442. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  443. <a name="screenprofile" class="tsd-anchor"></a>
  444. <h3>Screen<wbr>Profile</h3>
  445. <div class="tsd-signature tsd-kind-icon">Screen<wbr>Profile<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"480p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"480p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"720p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"720p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"1080p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"1080p_2"</span></div>
  446. <aside class="tsd-sources">
  447. </aside>
  448. <div class="tsd-comment tsd-typography">
  449. <div class="lead">
  450. <p>预设的屏幕共享视频 Profile</p>
  451. </div>
  452. <table>
  453. <thead>
  454. <tr>
  455. <th align="center">名称</th>
  456. <th align="center">视频宽</th>
  457. <th align="center">视频高</th>
  458. <th align="center">帧率 (fps)</th>
  459. <th align="center">码率 (kbps)</th>
  460. </tr>
  461. </thead>
  462. <tbody><tr>
  463. <td align="center">480p</td>
  464. <td align="center">640</td>
  465. <td align="center">480</td>
  466. <td align="center">5</td>
  467. <td align="center">600</td>
  468. </tr>
  469. <tr>
  470. <td align="center">480p_2</td>
  471. <td align="center">640</td>
  472. <td align="center">480</td>
  473. <td align="center">30</td>
  474. <td align="center">1000</td>
  475. </tr>
  476. <tr>
  477. <td align="center">720p</td>
  478. <td align="center">1280</td>
  479. <td align="center">720</td>
  480. <td align="center">5</td>
  481. <td align="center">1000</td>
  482. </tr>
  483. <tr>
  484. <td align="center">720p_2</td>
  485. <td align="center">1280</td>
  486. <td align="center">720</td>
  487. <td align="center">30</td>
  488. <td align="center">2000</td>
  489. </tr>
  490. <tr>
  491. <td align="center">1080p</td>
  492. <td align="center">1920</td>
  493. <td align="center">1080</td>
  494. <td align="center">5</td>
  495. <td align="center">1500</td>
  496. </tr>
  497. <tr>
  498. <td align="center">1080p_2</td>
  499. <td align="center">1920</td>
  500. <td align="center">1080</td>
  501. <td align="center">30</td>
  502. <td align="center">2500</td>
  503. </tr>
  504. </tbody></table>
  505. </div>
  506. </section>
  507. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  508. <a name="switchdevicetype" class="tsd-anchor"></a>
  509. <h3>Switch<wbr>Device<wbr>Type</h3>
  510. <div class="tsd-signature tsd-kind-icon">Switch<wbr>Device<wbr>Type<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"audio"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"video"</span></div>
  511. <aside class="tsd-sources">
  512. </aside>
  513. <div class="tsd-comment tsd-typography">
  514. <div class="lead">
  515. <p>切换设备的类型</p>
  516. </div>
  517. </div>
  518. </section>
  519. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  520. <a name="videocodec" class="tsd-anchor"></a>
  521. <h3>Video<wbr>Codec</h3>
  522. <div class="tsd-signature tsd-kind-icon">Video<wbr>Codec<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"vp8"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"h264"</span></div>
  523. <aside class="tsd-sources">
  524. </aside>
  525. <div class="tsd-comment tsd-typography">
  526. <div class="lead">
  527. <p>视频编解码格式</p>
  528. </div>
  529. </div>
  530. </section>
  531. <section class="tsd-panel tsd-member tsd-kind-type-alias tsd-is-external">
  532. <a name="videoprofile" class="tsd-anchor"></a>
  533. <h3>Video<wbr>Profile</h3>
  534. <div class="tsd-signature tsd-kind-icon">Video<wbr>Profile<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">"180p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"180p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"240p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"360p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"360p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"480p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"720p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"720p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"720p_3"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"1080p"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"1080p_2"</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">"1080p_3"</span></div>
  535. <aside class="tsd-sources">
  536. </aside>
  537. <div class="tsd-comment tsd-typography">
  538. <div class="lead">
  539. <p>预设的视频 Profile</p>
  540. </div>
  541. <table>
  542. <thead>
  543. <tr>
  544. <th align="center">名称</th>
  545. <th align="center">视频宽</th>
  546. <th align="center">视频高</th>
  547. <th align="center">帧率 (fps)</th>
  548. <th align="center">码率 (kbps)</th>
  549. </tr>
  550. </thead>
  551. <tbody><tr>
  552. <td align="center">180p</td>
  553. <td align="center">240</td>
  554. <td align="center">180</td>
  555. <td align="center">15</td>
  556. <td align="center">200</td>
  557. </tr>
  558. <tr>
  559. <td align="center">180p_2</td>
  560. <td align="center">320</td>
  561. <td align="center">180</td>
  562. <td align="center">15</td>
  563. <td align="center">300</td>
  564. </tr>
  565. <tr>
  566. <td align="center">240p</td>
  567. <td align="center">320</td>
  568. <td align="center">240</td>
  569. <td align="center">15</td>
  570. <td align="center">400</td>
  571. </tr>
  572. <tr>
  573. <td align="center">360p</td>
  574. <td align="center">480</td>
  575. <td align="center">360</td>
  576. <td align="center">15</td>
  577. <td align="center">400</td>
  578. </tr>
  579. <tr>
  580. <td align="center">360p_2</td>
  581. <td align="center">640</td>
  582. <td align="center">360</td>
  583. <td align="center">15</td>
  584. <td align="center">500</td>
  585. </tr>
  586. <tr>
  587. <td align="center">480p</td>
  588. <td align="center">640</td>
  589. <td align="center">480</td>
  590. <td align="center">15</td>
  591. <td align="center">600</td>
  592. </tr>
  593. <tr>
  594. <td align="center">720p</td>
  595. <td align="center">1280</td>
  596. <td align="center">720</td>
  597. <td align="center">15</td>
  598. <td align="center">1000</td>
  599. </tr>
  600. <tr>
  601. <td align="center">720p_2</td>
  602. <td align="center">1280</td>
  603. <td align="center">720</td>
  604. <td align="center">15</td>
  605. <td align="center">1500</td>
  606. </tr>
  607. <tr>
  608. <td align="center">720p_3</td>
  609. <td align="center">1280</td>
  610. <td align="center">720</td>
  611. <td align="center">30</td>
  612. <td align="center">2000</td>
  613. </tr>
  614. <tr>
  615. <td align="center">1080p</td>
  616. <td align="center">1920</td>
  617. <td align="center">1080</td>
  618. <td align="center">15</td>
  619. <td align="center">1500</td>
  620. </tr>
  621. <tr>
  622. <td align="center">1080p_2</td>
  623. <td align="center">1920</td>
  624. <td align="center">1080</td>
  625. <td align="center">15</td>
  626. <td align="center">2000</td>
  627. </tr>
  628. <tr>
  629. <td align="center">1080p_3</td>
  630. <td align="center">1920</td>
  631. <td align="center">1080</td>
  632. <td align="center">30</td>
  633. <td align="center">2500</td>
  634. </tr>
  635. </tbody></table>
  636. </div>
  637. </section>
  638. </section>
  639. <section class="tsd-panel-group tsd-member-group tsd-is-external">
  640. <h2>Variables</h2>
  641. <section class="tsd-panel tsd-member tsd-kind-variable tsd-is-external">
  642. <a name="version" class="tsd-anchor"></a>
  643. <h3><span class="tsd-flag ts-flagConst">Const</span> version</h3>
  644. <div class="tsd-signature tsd-kind-icon">version<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol"> = __VERSION__</span></div>
  645. <aside class="tsd-sources">
  646. </aside>
  647. <div class="tsd-comment tsd-typography">
  648. <div class="lead">
  649. <p>当前 sdk 的版本号</p>
  650. </div>
  651. </div>
  652. </section>
  653. </section>
  654. <section class="tsd-panel-group tsd-member-group ">
  655. <h2>Functions</h2>
  656. <section class="tsd-panel tsd-member tsd-kind-function">
  657. <a name="createclient" class="tsd-anchor"></a>
  658. <h3>create<wbr>Client</h3>
  659. <ul class="tsd-signatures tsd-kind-function">
  660. <li class="tsd-signature tsd-kind-icon">create<wbr>Client<span class="tsd-signature-symbol">(</span>appId<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span>, opts<span class="tsd-signature-symbol">?: </span><a href="interfaces/clientoptions.html" class="tsd-signature-type">ClientOptions</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><a href="classes/client.html" class="tsd-signature-type">Client</a></li>
  661. </ul>
  662. <ul class="tsd-descriptions">
  663. <li class="tsd-description">
  664. <aside class="tsd-sources">
  665. </aside>
  666. <div class="tsd-comment tsd-typography">
  667. <div class="lead">
  668. <p>创建客户端</p>
  669. </div>
  670. <dl class="tsd-comment-tags">
  671. <dt>example</dt>
  672. <dd><pre><code class="language-js"><span class="hljs-keyword">const</span> client = createClient(<span class="hljs-string">&#x27;AppID&#x27;</span>);
  673. client
  674. .join(<span class="hljs-string">&#x27;roomId&#x27;</span>, <span class="hljs-string">&#x27;userId&#x27;</span>, <span class="hljs-string">&#x27;token&#x27;</span>)
  675. .then(<span class="hljs-function">() =&gt;</span> {
  676. client.publish(localStream);
  677. })
  678. .catch(<span class="hljs-function">(<span class="hljs-params">err</span>) =&gt;</span> {
  679. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`加入房间失败 <span class="hljs-subst">${err}</span>`</span>);
  680. });</code></pre>
  681. </dd>
  682. <dt>throws</dt>
  683. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  684. </dd>
  685. </dl>
  686. </div>
  687. <h4 class="tsd-parameters-title">Parameters</h4>
  688. <ul class="tsd-parameters">
  689. <li>
  690. <h5>appId: <span class="tsd-signature-type">string</span></h5>
  691. <div class="tsd-comment tsd-typography">
  692. <p>应用 ID,可在控制台查看</p>
  693. </div>
  694. </li>
  695. <li>
  696. <h5><span class="tsd-flag ts-flagOptional">Optional</span> opts: <a href="interfaces/clientoptions.html" class="tsd-signature-type">ClientOptions</a></h5>
  697. <div class="tsd-comment tsd-typography">
  698. <p>定义客户端的属性</p>
  699. </div>
  700. </li>
  701. </ul>
  702. <h4 class="tsd-returns-title">Returns <a href="classes/client.html" class="tsd-signature-type">Client</a></h4>
  703. </li>
  704. </ul>
  705. </section>
  706. <section class="tsd-panel tsd-member tsd-kind-function">
  707. <a name="createstream" class="tsd-anchor"></a>
  708. <h3>create<wbr>Stream</h3>
  709. <ul class="tsd-signatures tsd-kind-function">
  710. <li class="tsd-signature tsd-kind-icon">create<wbr>Stream<span class="tsd-signature-symbol">(</span>opts<span class="tsd-signature-symbol">: </span><a href="interfaces/localstreamoptions.html" class="tsd-signature-type">LocalStreamOptions</a>, id<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">undefined</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><a href="classes/localstream.html" class="tsd-signature-type">LocalStream</a></li>
  711. </ul>
  712. <ul class="tsd-descriptions">
  713. <li class="tsd-description">
  714. <aside class="tsd-sources">
  715. </aside>
  716. <div class="tsd-comment tsd-typography">
  717. <div class="lead">
  718. <p>创建本地流</p>
  719. </div>
  720. <dl class="tsd-comment-tags">
  721. <dt>example</dt>
  722. <dd><pre><code class="language-js"><span class="hljs-keyword">const</span> localStream = createStream({ <span class="hljs-attr">audio</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">video</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">screen</span>: <span class="hljs-literal">false</span> });
  723. localStream
  724. .init()
  725. .then(<span class="hljs-function">() =&gt;</span> {
  726. localStream
  727. .play(container)
  728. .catch(<span class="hljs-function">(<span class="hljs-params">err</span>) =&gt;</span> {<span class="hljs-built_in">console</span>.log(<span class="hljs-string">`播放失败: <span class="hljs-subst">${err}</span>`</span>)});
  729. })
  730. .catch(<span class="hljs-function">(<span class="hljs-params">err</span>) =&gt;</span> {
  731. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`本地流初始化失败 <span class="hljs-subst">${err}</span>`</span>);
  732. });</code></pre>
  733. </dd>
  734. <dt>throws</dt>
  735. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  736. </dd>
  737. </dl>
  738. </div>
  739. <h4 class="tsd-parameters-title">Parameters</h4>
  740. <ul class="tsd-parameters">
  741. <li>
  742. <h5>opts: <a href="interfaces/localstreamoptions.html" class="tsd-signature-type">LocalStreamOptions</a></h5>
  743. <div class="tsd-comment tsd-typography">
  744. <p>必传,定义本地音视频流的属性</p>
  745. <blockquote>
  746. <p>注:</p>
  747. <ol>
  748. <li>video, screen 不可同时为 true</li>
  749. <li>audio, video, screen 不可同时为 false</li>
  750. <li>若指定了 file,则 init 时将优先使用 file 来创建初始化本地流的视频</li>
  751. <li>screenAudio 在不同浏览器上表现不同,参见 <a href="interfaces/localstreamoptions.html">LocalStreamOptions</a></li>
  752. </ol>
  753. </blockquote>
  754. </div>
  755. </li>
  756. <li>
  757. <h5><span class="tsd-flag ts-flagOptional">Optional</span> id: <span class="tsd-signature-type">undefined</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">string</span></h5>
  758. <div class="tsd-comment tsd-typography">
  759. <p>选传,指定本地流的 ID,请注意创建多条流时,不可传入重复值</p>
  760. </div>
  761. </li>
  762. </ul>
  763. <h4 class="tsd-returns-title">Returns <a href="classes/localstream.html" class="tsd-signature-type">LocalStream</a></h4>
  764. </li>
  765. </ul>
  766. </section>
  767. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  768. <a name="devicedetection" class="tsd-anchor"></a>
  769. <h3>device<wbr>Detection</h3>
  770. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  771. <li class="tsd-signature tsd-kind-icon">device<wbr>Detection<span class="tsd-signature-symbol">(</span>options<span class="tsd-signature-symbol">: </span><a href="interfaces/devicedetectionoptions.html" class="tsd-signature-type">DeviceDetectionOptions</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">void</span><span class="tsd-signature-symbol">&gt;</span></li>
  772. </ul>
  773. <ul class="tsd-descriptions">
  774. <li class="tsd-description">
  775. <aside class="tsd-sources">
  776. </aside>
  777. <div class="tsd-comment tsd-typography">
  778. <div class="lead">
  779. <p>设备可用性检测 - 创建包含麦克风音频或摄像头视频的本地流时,有可能因为麦克风或摄像头设备问题(如驱动问题,或未经授权等),导致无法正确创建。此方法可用于设备检测,根据检测结果,再决定创建本地流时启用麦克风或摄像头或麦克风和摄像头</p>
  780. </div>
  781. <dl class="tsd-comment-tags">
  782. <dt>example</dt>
  783. <dd><pre><code class="language-js">deviceDetection({<span class="hljs-attr">audio</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">video</span>: <span class="hljs-literal">true</span>})
  784. .then(<span class="hljs-function">() =&gt;</span> {
  785. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">&#x27;设备可用&#x27;</span>);
  786. })
  787. .catch(<span class="hljs-function"><span class="hljs-params">err</span> =&gt;</span> {
  788. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`设备不可用,<span class="hljs-subst">${err}</span>`</span>);
  789. });</code></pre>
  790. </dd>
  791. <dt>reject</dt>
  792. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  793. </dd>
  794. </dl>
  795. </div>
  796. <h4 class="tsd-parameters-title">Parameters</h4>
  797. <ul class="tsd-parameters">
  798. <li>
  799. <h5>options: <a href="interfaces/devicedetectionoptions.html" class="tsd-signature-type">DeviceDetectionOptions</a></h5>
  800. <div class="tsd-comment tsd-typography">
  801. <p>需指定设备时,请传入设备 ID</p>
  802. </div>
  803. </li>
  804. </ul>
  805. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">void</span><span class="tsd-signature-symbol">&gt;</span></h4>
  806. </li>
  807. </ul>
  808. </section>
  809. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  810. <a name="generatetoken" class="tsd-anchor"></a>
  811. <h3>generate<wbr>Token</h3>
  812. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  813. <li class="tsd-signature tsd-kind-icon">generate<wbr>Token<span class="tsd-signature-symbol">(</span>appId<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span>, appKey<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span>, roomId<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span>, userId<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span></li>
  814. </ul>
  815. <ul class="tsd-descriptions">
  816. <li class="tsd-description">
  817. <aside class="tsd-sources">
  818. </aside>
  819. <div class="tsd-comment tsd-typography">
  820. <div class="lead">
  821. <p>根据 AppId,AppKey,RoomId,UserId 生成 token,用于开发阶段临时快速的加入房间并验证功能,由于 AppKey 不可暴露于公网,因此生产环境中不建议使用此方法生成 token。</p>
  822. </div>
  823. <dl class="tsd-comment-tags">
  824. <dt>example</dt>
  825. <dd><pre><code class="language-js"><span class="hljs-keyword">const</span> token = generateToken(<span class="hljs-string">&#x27;urtc-xxx&#x27;</span>, <span class="hljs-string">&#x27;yyy&#x27;</span>, <span class="hljs-string">&#x27;roomId&#x27;</span>, <span class="hljs-string">&#x27;userId&#x27;</span>);
  826. client.join(<span class="hljs-string">&#x27;roomId&#x27;</span>, <span class="hljs-string">&#x27;userId&#x27;</span>, token);</code></pre>
  827. </dd>
  828. </dl>
  829. </div>
  830. <h4 class="tsd-parameters-title">Parameters</h4>
  831. <ul class="tsd-parameters">
  832. <li>
  833. <h5>appId: <span class="tsd-signature-type">string</span></h5>
  834. <div class="tsd-comment tsd-typography">
  835. <p>应用 ID,可在控制台查看</p>
  836. </div>
  837. </li>
  838. <li>
  839. <h5>appKey: <span class="tsd-signature-type">string</span></h5>
  840. <div class="tsd-comment tsd-typography">
  841. <p>应用密钥,可在控制台查看</p>
  842. </div>
  843. </li>
  844. <li>
  845. <h5>roomId: <span class="tsd-signature-type">string</span></h5>
  846. <div class="tsd-comment tsd-typography">
  847. <p>房间 ID</p>
  848. </div>
  849. </li>
  850. <li>
  851. <h5>userId: <span class="tsd-signature-type">string</span></h5>
  852. <div class="tsd-comment tsd-typography">
  853. <p>用户 ID</p>
  854. </div>
  855. </li>
  856. </ul>
  857. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4>
  858. </li>
  859. </ul>
  860. </section>
  861. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  862. <a name="getcameras" class="tsd-anchor"></a>
  863. <h3>get<wbr>Cameras</h3>
  864. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  865. <li class="tsd-signature tsd-kind-icon">get<wbr>Cameras<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></li>
  866. </ul>
  867. <ul class="tsd-descriptions">
  868. <li class="tsd-description">
  869. <aside class="tsd-sources">
  870. </aside>
  871. <div class="tsd-comment tsd-typography">
  872. <div class="lead">
  873. <p>获取摄像头设备列表,点击 <a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo">MediaDeviceInfo</a> 查看详情</p>
  874. </div>
  875. <dl class="tsd-comment-tags">
  876. <dt>example</dt>
  877. <dd><pre><code class="language-js">getCameras()
  878. .then(<span class="hljs-function"><span class="hljs-params">devices</span> =&gt;</span> {
  879. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表成功:`</span>, devices);
  880. })
  881. .catch(<span class="hljs-function"><span class="hljs-params">err</span> =&gt;</span> {
  882. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表失败:<span class="hljs-subst">${err}</span>`</span>);
  883. });</code></pre>
  884. </dd>
  885. <dt>reject</dt>
  886. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  887. </dd>
  888. </dl>
  889. </div>
  890. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></h4>
  891. </li>
  892. </ul>
  893. </section>
  894. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  895. <a name="getdevices" class="tsd-anchor"></a>
  896. <h3>get<wbr>Devices</h3>
  897. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  898. <li class="tsd-signature tsd-kind-icon">get<wbr>Devices<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></li>
  899. </ul>
  900. <ul class="tsd-descriptions">
  901. <li class="tsd-description">
  902. <aside class="tsd-sources">
  903. </aside>
  904. <div class="tsd-comment tsd-typography">
  905. <div class="lead">
  906. <p>获取音视频输入/输出设备列表,点击 <a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo">MediaDeviceInfo</a> 查看详情</p>
  907. </div>
  908. <dl class="tsd-comment-tags">
  909. <dt>example</dt>
  910. <dd><pre><code class="language-js">getDevices()
  911. .then(<span class="hljs-function"><span class="hljs-params">devices</span> =&gt;</span> {
  912. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表成功:`</span>, devices);
  913. })
  914. .catch(<span class="hljs-function"><span class="hljs-params">err</span> =&gt;</span> {
  915. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表失败:<span class="hljs-subst">${err}</span>`</span>);
  916. });</code></pre>
  917. </dd>
  918. <dt>reject</dt>
  919. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  920. </dd>
  921. </dl>
  922. </div>
  923. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></h4>
  924. </li>
  925. </ul>
  926. </section>
  927. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  928. <a name="getloudspeakers" class="tsd-anchor"></a>
  929. <h3>get<wbr>Loudspeakers</h3>
  930. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  931. <li class="tsd-signature tsd-kind-icon">get<wbr>Loudspeakers<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></li>
  932. </ul>
  933. <ul class="tsd-descriptions">
  934. <li class="tsd-description">
  935. <aside class="tsd-sources">
  936. </aside>
  937. <div class="tsd-comment tsd-typography">
  938. <div class="lead">
  939. <p>获取扬声器设备列表,点击 <a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo">MediaDeviceInfo</a> 查看详情</p>
  940. </div>
  941. <dl class="tsd-comment-tags">
  942. <dt>example</dt>
  943. <dd><pre><code class="language-js">getLoudspeakers()
  944. .then(<span class="hljs-function"><span class="hljs-params">devices</span> =&gt;</span> {
  945. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表成功:`</span>, devices);
  946. })
  947. .catch(<span class="hljs-function"><span class="hljs-params">err</span> =&gt;</span> {
  948. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表失败:<span class="hljs-subst">${err}</span>`</span>);
  949. });</code></pre>
  950. </dd>
  951. <dt>reject</dt>
  952. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  953. </dd>
  954. </dl>
  955. </div>
  956. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></h4>
  957. </li>
  958. </ul>
  959. </section>
  960. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  961. <a name="getmicrophones" class="tsd-anchor"></a>
  962. <h3>get<wbr>Microphones</h3>
  963. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  964. <li class="tsd-signature tsd-kind-icon">get<wbr>Microphones<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></li>
  965. </ul>
  966. <ul class="tsd-descriptions">
  967. <li class="tsd-description">
  968. <aside class="tsd-sources">
  969. </aside>
  970. <div class="tsd-comment tsd-typography">
  971. <div class="lead">
  972. <p>获取麦克风设备列表,点击 <a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo">MediaDeviceInfo</a> 查看详情</p>
  973. </div>
  974. <dl class="tsd-comment-tags">
  975. <dt>example</dt>
  976. <dd><pre><code class="language-js">getMicrophones()
  977. .then(<span class="hljs-function"><span class="hljs-params">devices</span> =&gt;</span> {
  978. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表成功:`</span>, devices);
  979. })
  980. .catch(<span class="hljs-function"><span class="hljs-params">err</span> =&gt;</span> {
  981. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`获取设备列表失败:<span class="hljs-subst">${err}</span>`</span>);
  982. });</code></pre>
  983. </dd>
  984. <dt>reject</dt>
  985. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  986. </dd>
  987. </dl>
  988. </div>
  989. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">MediaDeviceInfo</span><span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">&gt;</span></h4>
  990. </li>
  991. </ul>
  992. </section>
  993. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  994. <a name="issupportscreenshare" class="tsd-anchor"></a>
  995. <h3>is<wbr>Support<wbr>Screen<wbr>Share</h3>
  996. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  997. <li class="tsd-signature tsd-kind-icon">is<wbr>Support<wbr>Screen<wbr>Share<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">boolean</span></li>
  998. </ul>
  999. <ul class="tsd-descriptions">
  1000. <li class="tsd-description">
  1001. <aside class="tsd-sources">
  1002. </aside>
  1003. <div class="tsd-comment tsd-typography">
  1004. <div class="lead">
  1005. <p>检测浏览器是否支持屏幕共享</p>
  1006. </div>
  1007. <dl class="tsd-comment-tags">
  1008. <dt>example</dt>
  1009. <dd><pre><code class="language-js"><span class="hljs-keyword">if</span> (!isSupportScreenShare()) {
  1010. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`当前浏览器不支持屏幕共享`</span>);
  1011. }</code></pre>
  1012. </dd>
  1013. </dl>
  1014. </div>
  1015. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">boolean</span></h4>
  1016. </li>
  1017. </ul>
  1018. </section>
  1019. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  1020. <a name="issupportwebrtc" class="tsd-anchor"></a>
  1021. <h3>is<wbr>Support<wbr>WebRTC</h3>
  1022. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  1023. <li class="tsd-signature tsd-kind-icon">is<wbr>Support<wbr>WebRTC<span class="tsd-signature-symbol">(</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">boolean</span></li>
  1024. </ul>
  1025. <ul class="tsd-descriptions">
  1026. <li class="tsd-description">
  1027. <aside class="tsd-sources">
  1028. </aside>
  1029. <div class="tsd-comment tsd-typography">
  1030. <div class="lead">
  1031. <p>检测浏览器是否完全(可访问本地音视频设备)支持 WebRTC。</p>
  1032. </div>
  1033. <dl class="tsd-comment-tags">
  1034. <dt>example</dt>
  1035. <dd><pre><code class="language-js"><span class="hljs-keyword">if</span> (!isSupportWebRTC()) {
  1036. <span class="hljs-built_in">console</span>.log(<span class="hljs-string">`当前浏览器不完全支持 WebRTC,建议使用 Chrome 浏览器,iOS 系统建议使用 Safari 浏览器`</span>);
  1037. }</code></pre>
  1038. </dd>
  1039. </dl>
  1040. </div>
  1041. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">boolean</span></h4>
  1042. </li>
  1043. </ul>
  1044. </section>
  1045. <section class="tsd-panel tsd-member tsd-kind-function">
  1046. <a name="reportlog" class="tsd-anchor"></a>
  1047. <h3>report<wbr>Log</h3>
  1048. <ul class="tsd-signatures tsd-kind-function">
  1049. <li class="tsd-signature tsd-kind-icon">report<wbr>Log<span class="tsd-signature-symbol">(</span>enable<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">boolean</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">void</span></li>
  1050. </ul>
  1051. <ul class="tsd-descriptions">
  1052. <li class="tsd-description">
  1053. <aside class="tsd-sources">
  1054. </aside>
  1055. <div class="tsd-comment tsd-typography">
  1056. <div class="lead">
  1057. <p>开启/关闭操作/错误/状态日志的上报,未调用时,默认开启上报日志</p>
  1058. </div>
  1059. <dl class="tsd-comment-tags">
  1060. <dt>example</dt>
  1061. <dd><pre><code class="language-js">reportLog(<span class="hljs-literal">false</span>); <span class="hljs-comment">// 关闭日志上报,关闭后,在线上出现错误时,将无法根据日志进行排查</span></code></pre>
  1062. </dd>
  1063. </dl>
  1064. </div>
  1065. <h4 class="tsd-parameters-title">Parameters</h4>
  1066. <ul class="tsd-parameters">
  1067. <li>
  1068. <h5>enable: <span class="tsd-signature-type">boolean</span></h5>
  1069. <div class="tsd-comment tsd-typography">
  1070. <p>是否开启上报</p>
  1071. </div>
  1072. </li>
  1073. </ul>
  1074. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">void</span></h4>
  1075. </li>
  1076. </ul>
  1077. </section>
  1078. <section class="tsd-panel tsd-member tsd-kind-function">
  1079. <a name="setloglevel" class="tsd-anchor"></a>
  1080. <h3>set<wbr>Log<wbr>Level</h3>
  1081. <ul class="tsd-signatures tsd-kind-function">
  1082. <li class="tsd-signature tsd-kind-icon">set<wbr>Log<wbr>Level<span class="tsd-signature-symbol">(</span>level<span class="tsd-signature-symbol">: </span><a href="index.html#loglevel" class="tsd-signature-type">LogLevel</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">void</span></li>
  1083. </ul>
  1084. <ul class="tsd-descriptions">
  1085. <li class="tsd-description">
  1086. <aside class="tsd-sources">
  1087. </aside>
  1088. <div class="tsd-comment tsd-typography">
  1089. <div class="lead">
  1090. <p>设置日志打印级别,用于打印出更多日志来调试或定位问题</p>
  1091. </div>
  1092. <dl class="tsd-comment-tags">
  1093. <dt>example</dt>
  1094. <dd><pre><code class="language-js">setLogLevel(<span class="hljs-string">&#x27;info&#x27;</span>);</code></pre>
  1095. </dd>
  1096. </dl>
  1097. </div>
  1098. <h4 class="tsd-parameters-title">Parameters</h4>
  1099. <ul class="tsd-parameters">
  1100. <li>
  1101. <h5>level: <a href="index.html#loglevel" class="tsd-signature-type">LogLevel</a></h5>
  1102. <div class="tsd-comment tsd-typography">
  1103. <p>日志级别,有 &#39;debug&#39;, &#39;info&#39;, &#39;warn&#39;, &#39;error&#39; 级别;</p>
  1104. </div>
  1105. </li>
  1106. </ul>
  1107. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">void</span></h4>
  1108. </li>
  1109. </ul>
  1110. </section>
  1111. <section class="tsd-panel tsd-member tsd-kind-function tsd-is-external">
  1112. <a name="setservers" class="tsd-anchor"></a>
  1113. <h3>set<wbr>Servers</h3>
  1114. <ul class="tsd-signatures tsd-kind-function tsd-is-external">
  1115. <li class="tsd-signature tsd-kind-icon">set<wbr>Servers<span class="tsd-signature-symbol">(</span>conf<span class="tsd-signature-symbol">: </span><a href="interfaces/serverconfig.html" class="tsd-signature-type">ServerConfig</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">void</span></li>
  1116. </ul>
  1117. <ul class="tsd-descriptions">
  1118. <li class="tsd-description">
  1119. <aside class="tsd-sources">
  1120. </aside>
  1121. <div class="tsd-comment tsd-typography">
  1122. <div class="lead">
  1123. <p>用于私有化部署时,指定部署的服务器地址</p>
  1124. </div>
  1125. <dl class="tsd-comment-tags">
  1126. <dt>example</dt>
  1127. <dd><pre><code class="language-js">setServers({
  1128. <span class="hljs-attr">gateway</span>: <span class="hljs-string">&#x27;https://private-rtc.com&#x27;</span>, <span class="hljs-comment">// 指定网关</span>
  1129. <span class="hljs-attr">log</span>: <span class="hljs-string">&#x27;https://log.private-rtc.com&#x27;</span>, <span class="hljs-comment">// 指定日志服务器</span>
  1130. });</code></pre>
  1131. <p><strong>特别地,单信令服务器时,不需要网关进行分配信令服务器,可以直接指定信令服务器</strong></p>
  1132. <pre><code class="language-js">setServers({
  1133. <span class="hljs-attr">signal</span>: <span class="hljs-string">&#x27;wss://private-rtc.com:5005&#x27;</span>, <span class="hljs-comment">// 直接指定信令服务器</span>
  1134. <span class="hljs-attr">log</span>: <span class="hljs-string">&#x27;https://log.private-rtc.com&#x27;</span>, <span class="hljs-comment">// 指定日志服务器</span>
  1135. });</code></pre>
  1136. </dd>
  1137. <dt>throws</dt>
  1138. <dd><p><a href="classes/rtcerror.html">RtcError</a></p>
  1139. </dd>
  1140. </dl>
  1141. </div>
  1142. <h4 class="tsd-parameters-title">Parameters</h4>
  1143. <ul class="tsd-parameters">
  1144. <li>
  1145. <h5>conf: <a href="interfaces/serverconfig.html" class="tsd-signature-type">ServerConfig</a></h5>
  1146. <div class="tsd-comment tsd-typography">
  1147. <p>服务器配置,具体描述参见 ServerConfig 的说明</p>
  1148. </div>
  1149. </li>
  1150. </ul>
  1151. <h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">void</span></h4>
  1152. </li>
  1153. </ul>
  1154. </section>
  1155. </section>
  1156. </div>
  1157. <div class="col-4 col-menu menu-sticky-wrap menu-highlight">
  1158. <nav class="tsd-navigation primary">
  1159. <ul>
  1160. <li class="globals current ">
  1161. <a href="index.html"><em>Globals</em></a>
  1162. </li>
  1163. </ul>
  1164. </nav>
  1165. <nav class="tsd-navigation secondary menu-sticky">
  1166. <ul class="before-current">
  1167. <li class=" tsd-kind-class tsd-is-external">
  1168. <a href="classes/client.html" class="tsd-kind-icon">Client</a>
  1169. </li>
  1170. <li class=" tsd-kind-class tsd-is-external">
  1171. <a href="classes/localstream.html" class="tsd-kind-icon">Local<wbr>Stream</a>
  1172. </li>
  1173. <li class=" tsd-kind-class tsd-is-external">
  1174. <a href="classes/remotestream.html" class="tsd-kind-icon">Remote<wbr>Stream</a>
  1175. </li>
  1176. <li class=" tsd-kind-class tsd-is-external">
  1177. <a href="classes/rtcerror.html" class="tsd-kind-icon">Rtc<wbr>Error</a>
  1178. </li>
  1179. <li class=" tsd-kind-class tsd-is-external">
  1180. <a href="classes/stream.html" class="tsd-kind-icon">Stream</a>
  1181. </li>
  1182. <li class=" tsd-kind-class tsd-is-external">
  1183. <a href="classes/user.html" class="tsd-kind-icon">User</a>
  1184. </li>
  1185. <li class=" tsd-kind-interface tsd-is-external">
  1186. <a href="interfaces/audiostats.html" class="tsd-kind-icon">Audio<wbr>Stats</a>
  1187. </li>
  1188. <li class=" tsd-kind-interface tsd-is-external">
  1189. <a href="interfaces/clientoptions.html" class="tsd-kind-icon">Client<wbr>Options</a>
  1190. </li>
  1191. <li class=" tsd-kind-interface tsd-is-external">
  1192. <a href="interfaces/connectionstates.html" class="tsd-kind-icon">Connection<wbr>States</a>
  1193. </li>
  1194. <li class=" tsd-kind-interface tsd-is-external">
  1195. <a href="interfaces/customvideoprofile.html" class="tsd-kind-icon">Custom<wbr>Video<wbr>Profile</a>
  1196. </li>
  1197. <li class=" tsd-kind-interface tsd-is-external">
  1198. <a href="interfaces/devicedetectionoptions.html" class="tsd-kind-icon">Device<wbr>Detection<wbr>Options</a>
  1199. </li>
  1200. <li class=" tsd-kind-interface tsd-is-external">
  1201. <a href="interfaces/joinoptions.html" class="tsd-kind-icon">Join<wbr>Options</a>
  1202. </li>
  1203. <li class=" tsd-kind-interface tsd-has-type-parameter tsd-is-external">
  1204. <a href="interfaces/listener.html" class="tsd-kind-icon">Listener</a>
  1205. </li>
  1206. <li class=" tsd-kind-interface tsd-is-external">
  1207. <a href="interfaces/localstreamoptions.html" class="tsd-kind-icon">Local<wbr>Stream<wbr>Options</a>
  1208. </li>
  1209. <li class=" tsd-kind-interface tsd-is-external">
  1210. <a href="interfaces/networkstats.html" class="tsd-kind-icon">Network<wbr>Stats</a>
  1211. </li>
  1212. <li class=" tsd-kind-interface tsd-is-external">
  1213. <a href="interfaces/playoptions.html" class="tsd-kind-icon">Play<wbr>Options</a>
  1214. </li>
  1215. <li class=" tsd-kind-interface tsd-has-type-parameter tsd-is-external">
  1216. <a href="interfaces/rtcevent.html" class="tsd-kind-icon">Rtc<wbr>Event</a>
  1217. </li>
  1218. <li class=" tsd-kind-interface tsd-is-external">
  1219. <a href="interfaces/serverconfig.html" class="tsd-kind-icon">Server<wbr>Config</a>
  1220. </li>
  1221. <li class=" tsd-kind-interface tsd-is-external">
  1222. <a href="interfaces/streamplugin.html" class="tsd-kind-icon">Stream<wbr>Plugin</a>
  1223. </li>
  1224. <li class=" tsd-kind-interface tsd-is-external">
  1225. <a href="interfaces/streamstats.html" class="tsd-kind-icon">Stream<wbr>Stats</a>
  1226. </li>
  1227. <li class=" tsd-kind-interface tsd-is-external">
  1228. <a href="interfaces/videostats.html" class="tsd-kind-icon">Video<wbr>Stats</a>
  1229. </li>
  1230. <li class=" tsd-kind-type-alias tsd-is-external">
  1231. <a href="index.html#audiocodec" class="tsd-kind-icon">Audio<wbr>Codec</a>
  1232. </li>
  1233. <li class=" tsd-kind-type-alias tsd-is-external">
  1234. <a href="index.html#connectionstate" class="tsd-kind-icon">Connection<wbr>State</a>
  1235. </li>
  1236. <li class=" tsd-kind-type-alias tsd-is-external">
  1237. <a href="index.html#errorcode" class="tsd-kind-icon">Error<wbr>Code</a>
  1238. </li>
  1239. <li class=" tsd-kind-type-alias tsd-is-external">
  1240. <a href="index.html#loglevel" class="tsd-kind-icon">Log<wbr>Level</a>
  1241. </li>
  1242. <li class=" tsd-kind-type-alias tsd-is-external">
  1243. <a href="index.html#mediatype" class="tsd-kind-icon">Media<wbr>Type</a>
  1244. </li>
  1245. <li class=" tsd-kind-type-alias tsd-is-external">
  1246. <a href="index.html#playervideofittype" class="tsd-kind-icon">Player<wbr>Video<wbr>Fit<wbr>Type</a>
  1247. </li>
  1248. <li class=" tsd-kind-type-alias tsd-is-external">
  1249. <a href="index.html#roletype" class="tsd-kind-icon">Role<wbr>Type</a>
  1250. </li>
  1251. <li class=" tsd-kind-type-alias tsd-is-external">
  1252. <a href="index.html#roomtype" class="tsd-kind-icon">Room<wbr>Type</a>
  1253. </li>
  1254. <li class=" tsd-kind-type-alias tsd-is-external">
  1255. <a href="index.html#rtcconnectionevent" class="tsd-kind-icon">Rtc<wbr>Connection<wbr>Event</a>
  1256. </li>
  1257. <li class=" tsd-kind-type-alias tsd-is-external">
  1258. <a href="index.html#rtcconnectioneventtype" class="tsd-kind-icon">Rtc<wbr>Connection<wbr>Event<wbr>Type</a>
  1259. </li>
  1260. <li class=" tsd-kind-type-alias tsd-is-external">
  1261. <a href="index.html#rtceventtype" class="tsd-kind-icon">Rtc<wbr>Event<wbr>Type</a>
  1262. </li>
  1263. <li class=" tsd-kind-type-alias tsd-is-external">
  1264. <a href="index.html#rtcstreamevent" class="tsd-kind-icon">Rtc<wbr>Stream<wbr>Event</a>
  1265. </li>
  1266. <li class=" tsd-kind-type-alias tsd-is-external">
  1267. <a href="index.html#rtcstreameventtype" class="tsd-kind-icon">Rtc<wbr>Stream<wbr>Event<wbr>Type</a>
  1268. </li>
  1269. <li class=" tsd-kind-type-alias tsd-is-external">
  1270. <a href="index.html#rtcuserevent" class="tsd-kind-icon">Rtc<wbr>User<wbr>Event</a>
  1271. </li>
  1272. <li class=" tsd-kind-type-alias tsd-is-external">
  1273. <a href="index.html#rtcusereventtype" class="tsd-kind-icon">Rtc<wbr>User<wbr>Event<wbr>Type</a>
  1274. </li>
  1275. <li class=" tsd-kind-type-alias tsd-is-external">
  1276. <a href="index.html#screenprofile" class="tsd-kind-icon">Screen<wbr>Profile</a>
  1277. </li>
  1278. <li class=" tsd-kind-type-alias tsd-is-external">
  1279. <a href="index.html#switchdevicetype" class="tsd-kind-icon">Switch<wbr>Device<wbr>Type</a>
  1280. </li>
  1281. <li class=" tsd-kind-type-alias tsd-is-external">
  1282. <a href="index.html#videocodec" class="tsd-kind-icon">Video<wbr>Codec</a>
  1283. </li>
  1284. <li class=" tsd-kind-type-alias tsd-is-external">
  1285. <a href="index.html#videoprofile" class="tsd-kind-icon">Video<wbr>Profile</a>
  1286. </li>
  1287. <li class=" tsd-kind-variable tsd-is-external">
  1288. <a href="index.html#version" class="tsd-kind-icon">version</a>
  1289. </li>
  1290. <li class=" tsd-kind-function">
  1291. <a href="index.html#createclient" class="tsd-kind-icon">create<wbr>Client</a>
  1292. </li>
  1293. <li class=" tsd-kind-function">
  1294. <a href="index.html#createstream" class="tsd-kind-icon">create<wbr>Stream</a>
  1295. </li>
  1296. <li class=" tsd-kind-function tsd-is-external">
  1297. <a href="index.html#devicedetection" class="tsd-kind-icon">device<wbr>Detection</a>
  1298. </li>
  1299. <li class=" tsd-kind-function tsd-is-external">
  1300. <a href="index.html#generatetoken" class="tsd-kind-icon">generate<wbr>Token</a>
  1301. </li>
  1302. <li class=" tsd-kind-function tsd-is-external">
  1303. <a href="index.html#getcameras" class="tsd-kind-icon">get<wbr>Cameras</a>
  1304. </li>
  1305. <li class=" tsd-kind-function tsd-is-external">
  1306. <a href="index.html#getdevices" class="tsd-kind-icon">get<wbr>Devices</a>
  1307. </li>
  1308. <li class=" tsd-kind-function tsd-is-external">
  1309. <a href="index.html#getloudspeakers" class="tsd-kind-icon">get<wbr>Loudspeakers</a>
  1310. </li>
  1311. <li class=" tsd-kind-function tsd-is-external">
  1312. <a href="index.html#getmicrophones" class="tsd-kind-icon">get<wbr>Microphones</a>
  1313. </li>
  1314. <li class=" tsd-kind-function tsd-is-external">
  1315. <a href="index.html#issupportscreenshare" class="tsd-kind-icon">is<wbr>Support<wbr>Screen<wbr>Share</a>
  1316. </li>
  1317. <li class=" tsd-kind-function tsd-is-external">
  1318. <a href="index.html#issupportwebrtc" class="tsd-kind-icon">is<wbr>Support<wbr>WebRTC</a>
  1319. </li>
  1320. <li class=" tsd-kind-function">
  1321. <a href="index.html#reportlog" class="tsd-kind-icon">report<wbr>Log</a>
  1322. </li>
  1323. <li class=" tsd-kind-function">
  1324. <a href="index.html#setloglevel" class="tsd-kind-icon">set<wbr>Log<wbr>Level</a>
  1325. </li>
  1326. <li class=" tsd-kind-function tsd-is-external">
  1327. <a href="index.html#setservers" class="tsd-kind-icon">set<wbr>Servers</a>
  1328. </li>
  1329. </ul>
  1330. </nav>
  1331. </div>
  1332. </div>
  1333. </div>
  1334. <footer class="with-border-bottom">
  1335. <div class="container">
  1336. <h2>Legend</h2>
  1337. <div class="tsd-legend-group">
  1338. </div>
  1339. </div>
  1340. </footer>
  1341. <div class="container tsd-generator">
  1342. <p>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p>
  1343. </div>
  1344. <div class="overlay"></div>
  1345. <script src="assets/js/main.js"></script>
  1346. </body>
  1347. </html>