localstreamoptions.html 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349
  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>LocalStreamOptions | @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. <script async src="../assets/js/search.js" id="search-script"></script>
  11. </head>
  12. <body>
  13. <header>
  14. <div class="tsd-page-toolbar">
  15. <div class="container">
  16. <div class="table-wrap">
  17. <div class="table-cell" id="tsd-search" data-index="../assets/js/search.json" data-base="..">
  18. <div class="field">
  19. <label for="tsd-search-field" class="tsd-widget search no-caption">Search</label>
  20. <input id="tsd-search-field" type="text" />
  21. </div>
  22. <ul class="results">
  23. <li class="state loading">Preparing search index...</li>
  24. <li class="state failure">The search index is not available</li>
  25. </ul>
  26. <a href="../index.html" class="title">@urtc/sdk-web</a>
  27. </div>
  28. <div class="table-cell" id="tsd-widgets">
  29. <div id="tsd-filter">
  30. <a href="#" class="tsd-widget options no-caption" data-toggle="options">Options</a>
  31. <div class="tsd-filter-group">
  32. <div class="tsd-select" id="tsd-filter-visibility">
  33. <span class="tsd-select-label">All</span>
  34. <ul class="tsd-select-list">
  35. <li data-value="public">Public</li>
  36. <li data-value="protected">Public/Protected</li>
  37. <li data-value="private" class="selected">All</li>
  38. </ul>
  39. </div>
  40. <input type="checkbox" id="tsd-filter-inherited" checked />
  41. <label class="tsd-widget" for="tsd-filter-inherited">Inherited</label>
  42. <input type="checkbox" id="tsd-filter-externals" checked />
  43. <label class="tsd-widget" for="tsd-filter-externals">Externals</label>
  44. </div>
  45. </div>
  46. <a href="#" class="tsd-widget menu no-caption" data-toggle="menu">Menu</a>
  47. </div>
  48. </div>
  49. </div>
  50. </div>
  51. <div class="tsd-page-title">
  52. <div class="container">
  53. <ul class="tsd-breadcrumb">
  54. <li>
  55. <a href="../index.html">@urtc/sdk-web</a>
  56. </li>
  57. <li>
  58. <a href="localstreamoptions.html">LocalStreamOptions</a>
  59. </li>
  60. </ul>
  61. <h1>Interface LocalStreamOptions</h1>
  62. </div>
  63. </div>
  64. </header>
  65. <div class="container container-main">
  66. <div class="row">
  67. <div class="col-8 col-content">
  68. <section class="tsd-panel tsd-comment">
  69. <div class="tsd-comment tsd-typography">
  70. <div class="lead">
  71. <p>创建本地流的参数</p>
  72. </div>
  73. </div>
  74. </section>
  75. <section class="tsd-panel tsd-hierarchy">
  76. <h3>Hierarchy</h3>
  77. <ul class="tsd-hierarchy">
  78. <li>
  79. <span class="target">LocalStreamOptions</span>
  80. </li>
  81. </ul>
  82. </section>
  83. <section class="tsd-panel-group tsd-index-group">
  84. <h2>Index</h2>
  85. <section class="tsd-panel tsd-index-panel">
  86. <div class="tsd-index-content">
  87. <section class="tsd-index-section ">
  88. <h3>Properties</h3>
  89. <ul class="tsd-index-list">
  90. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#audio" class="tsd-kind-icon">audio</a></li>
  91. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#audiosource" class="tsd-kind-icon">audio<wbr>Source</a></li>
  92. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#cameraid" class="tsd-kind-icon">camera<wbr>Id</a></li>
  93. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#facingmode" class="tsd-kind-icon">facing<wbr>Mode</a></li>
  94. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#file" class="tsd-kind-icon">file</a></li>
  95. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#id" class="tsd-kind-icon">id</a></li>
  96. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#microphoneid" class="tsd-kind-icon">microphone<wbr>Id</a></li>
  97. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#screen" class="tsd-kind-icon">screen</a></li>
  98. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#screenaudio" class="tsd-kind-icon">screen<wbr>Audio</a></li>
  99. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#userid" class="tsd-kind-icon">user<wbr>Id</a></li>
  100. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#video" class="tsd-kind-icon">video</a></li>
  101. <li class="tsd-kind-property tsd-parent-kind-interface"><a href="localstreamoptions.html#videosource" class="tsd-kind-icon">video<wbr>Source</a></li>
  102. </ul>
  103. </section>
  104. </div>
  105. </section>
  106. </section>
  107. <section class="tsd-panel-group tsd-member-group ">
  108. <h2>Properties</h2>
  109. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  110. <a name="audio" class="tsd-anchor"></a>
  111. <h3>audio</h3>
  112. <div class="tsd-signature tsd-kind-icon">audio<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span></div>
  113. <aside class="tsd-sources">
  114. </aside>
  115. <div class="tsd-comment tsd-typography">
  116. <div class="lead">
  117. <p>是否读取麦克风设备来初始化本地流的音频</p>
  118. </div>
  119. </div>
  120. </section>
  121. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  122. <a name="audiosource" class="tsd-anchor"></a>
  123. <h3><span class="tsd-flag ts-flagOptional">Optional</span> audio<wbr>Source</h3>
  124. <div class="tsd-signature tsd-kind-icon">audio<wbr>Source<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">MediaStreamTrack</span></div>
  125. <aside class="tsd-sources">
  126. </aside>
  127. <div class="tsd-comment tsd-typography">
  128. <div class="lead">
  129. <p>选传,音频轨道,参见 <a href="https://developer.mozilla.org/zh-CN/docs/Web/API/MediaStreamTrack" class="external">MediaStreamTrack</a>,指定本地流的音频源。
  130. 注:若指定,将直接采用该音频轨道作为本地流的音频源,不再按 audio 设置的读取麦克风作为音频源,或 screenAudio 设置的读取屏幕共享的音频作为音频源。</p>
  131. </div>
  132. </div>
  133. </section>
  134. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  135. <a name="cameraid" class="tsd-anchor"></a>
  136. <h3><span class="tsd-flag ts-flagOptional">Optional</span> camera<wbr>Id</h3>
  137. <div class="tsd-signature tsd-kind-icon">camera<wbr>Id<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span></div>
  138. <aside class="tsd-sources">
  139. </aside>
  140. <div class="tsd-comment tsd-typography">
  141. <div class="lead">
  142. <p>选传,读取指定设备ID的摄像头</p>
  143. </div>
  144. </div>
  145. </section>
  146. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  147. <a name="facingmode" class="tsd-anchor"></a>
  148. <h3><span class="tsd-flag ts-flagOptional">Optional</span> facing<wbr>Mode</h3>
  149. <div class="tsd-signature tsd-kind-icon">facing<wbr>Mode<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;user&quot;</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">&quot;environment&quot;</span></div>
  150. <aside class="tsd-sources">
  151. </aside>
  152. <div class="tsd-comment tsd-typography">
  153. <div class="lead">
  154. <p>选传,在移动设备上,可以设置该参数选择使用前置或后置摄像头,其中,FacingMode 为 &#39;user&#39;(前置摄像头)或 &#39;environment&#39;(后置摄像头)</p>
  155. </div>
  156. </div>
  157. </section>
  158. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  159. <a name="file" class="tsd-anchor"></a>
  160. <h3><span class="tsd-flag ts-flagOptional">Optional</span> file</h3>
  161. <div class="tsd-signature tsd-kind-icon">file<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol"> | </span><span class="tsd-signature-type">File</span></div>
  162. <aside class="tsd-sources">
  163. </aside>
  164. <div class="tsd-comment tsd-typography">
  165. <div class="lead">
  166. <p>选传,使用图片初始化本地流的视频。
  167. 注:若指定,将直接采用图片生成的视频作为本地流的视频源,不再按 video 设置的读取摄像头作为视频源,或 screen 设置的读取屏幕共享的画面作为视频源。</p>
  168. </div>
  169. </div>
  170. </section>
  171. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  172. <a name="id" class="tsd-anchor"></a>
  173. <h3><span class="tsd-flag ts-flagOptional">Optional</span> id</h3>
  174. <div class="tsd-signature tsd-kind-icon">id<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span></div>
  175. <aside class="tsd-sources">
  176. </aside>
  177. <div class="tsd-comment tsd-typography">
  178. <div class="lead">
  179. <p>选传,指定本地流的 ID,请注意创建多条流时,不可传入重复值</p>
  180. </div>
  181. </div>
  182. </section>
  183. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  184. <a name="microphoneid" class="tsd-anchor"></a>
  185. <h3><span class="tsd-flag ts-flagOptional">Optional</span> microphone<wbr>Id</h3>
  186. <div class="tsd-signature tsd-kind-icon">microphone<wbr>Id<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span></div>
  187. <aside class="tsd-sources">
  188. </aside>
  189. <div class="tsd-comment tsd-typography">
  190. <div class="lead">
  191. <p>选传,读取指定设备ID的麦克风</p>
  192. </div>
  193. </div>
  194. </section>
  195. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  196. <a name="screen" class="tsd-anchor"></a>
  197. <h3>screen</h3>
  198. <div class="tsd-signature tsd-kind-icon">screen<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span></div>
  199. <aside class="tsd-sources">
  200. </aside>
  201. <div class="tsd-comment tsd-typography">
  202. <div class="lead">
  203. <p>是否使用屏幕共享的画面来初始化本地流</p>
  204. </div>
  205. </div>
  206. </section>
  207. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  208. <a name="screenaudio" class="tsd-anchor"></a>
  209. <h3><span class="tsd-flag ts-flagOptional">Optional</span> screen<wbr>Audio</h3>
  210. <div class="tsd-signature tsd-kind-icon">screen<wbr>Audio<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span></div>
  211. <aside class="tsd-sources">
  212. </aside>
  213. <div class="tsd-comment tsd-typography">
  214. <div class="lead">
  215. <p>选传,是否读取屏幕共享的音频,默认: false</p>
  216. <blockquote>
  217. <p>注:仅部分浏览器支持,如 Chrome 74,且不同系统表现不同,如 windows 会读取桌面音频,macOS 只支持读取浏览器 tab 中的音频。</p>
  218. </blockquote>
  219. </div>
  220. </div>
  221. </section>
  222. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  223. <a name="userid" class="tsd-anchor"></a>
  224. <h3><span class="tsd-flag ts-flagOptional">Optional</span> user<wbr>Id</h3>
  225. <div class="tsd-signature tsd-kind-icon">user<wbr>Id<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span></div>
  226. <aside class="tsd-sources">
  227. </aside>
  228. <div class="tsd-comment tsd-typography">
  229. <div class="lead">
  230. <p>选传,指定本地流的 userId</p>
  231. </div>
  232. </div>
  233. </section>
  234. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  235. <a name="video" class="tsd-anchor"></a>
  236. <h3>video</h3>
  237. <div class="tsd-signature tsd-kind-icon">video<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span></div>
  238. <aside class="tsd-sources">
  239. </aside>
  240. <div class="tsd-comment tsd-typography">
  241. <div class="lead">
  242. <p>是否读取摄像头设备来初始化本地流的视频</p>
  243. </div>
  244. </div>
  245. </section>
  246. <section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
  247. <a name="videosource" class="tsd-anchor"></a>
  248. <h3><span class="tsd-flag ts-flagOptional">Optional</span> video<wbr>Source</h3>
  249. <div class="tsd-signature tsd-kind-icon">video<wbr>Source<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">MediaStreamTrack</span></div>
  250. <aside class="tsd-sources">
  251. </aside>
  252. <div class="tsd-comment tsd-typography">
  253. <div class="lead">
  254. <p>选传,视频轨道,参见 <a href="https://developer.mozilla.org/zh-CN/docs/Web/API/MediaStreamTrack" class="external">MediaStreamTrack</a>,指定本地流的视频源。
  255. 注:若指定,将直接采用该视频轨道作为本地流的视频源,不再按 video 设置的读取摄像头作为视频源,或 screen 设置的读取屏幕共享的画面作为视频源,或 file 设置的使用图片生成视频源。</p>
  256. </div>
  257. </div>
  258. </section>
  259. </section>
  260. </div>
  261. <div class="col-4 col-menu menu-sticky-wrap menu-highlight">
  262. <nav class="tsd-navigation primary">
  263. <ul>
  264. <li class=" ">
  265. <a href="../index.html">Exports</a>
  266. </li>
  267. </ul>
  268. </nav>
  269. <nav class="tsd-navigation secondary menu-sticky">
  270. <ul class="before-current">
  271. </ul>
  272. <ul class="current">
  273. <li class="current tsd-kind-interface">
  274. <a href="localstreamoptions.html" class="tsd-kind-icon">Local<wbr>Stream<wbr>Options</a>
  275. <ul>
  276. <li class=" tsd-kind-property tsd-parent-kind-interface">
  277. <a href="localstreamoptions.html#audio" class="tsd-kind-icon">audio</a>
  278. </li>
  279. <li class=" tsd-kind-property tsd-parent-kind-interface">
  280. <a href="localstreamoptions.html#audiosource" class="tsd-kind-icon">audio<wbr>Source</a>
  281. </li>
  282. <li class=" tsd-kind-property tsd-parent-kind-interface">
  283. <a href="localstreamoptions.html#cameraid" class="tsd-kind-icon">camera<wbr>Id</a>
  284. </li>
  285. <li class=" tsd-kind-property tsd-parent-kind-interface">
  286. <a href="localstreamoptions.html#facingmode" class="tsd-kind-icon">facing<wbr>Mode</a>
  287. </li>
  288. <li class=" tsd-kind-property tsd-parent-kind-interface">
  289. <a href="localstreamoptions.html#file" class="tsd-kind-icon">file</a>
  290. </li>
  291. <li class=" tsd-kind-property tsd-parent-kind-interface">
  292. <a href="localstreamoptions.html#id" class="tsd-kind-icon">id</a>
  293. </li>
  294. <li class=" tsd-kind-property tsd-parent-kind-interface">
  295. <a href="localstreamoptions.html#microphoneid" class="tsd-kind-icon">microphone<wbr>Id</a>
  296. </li>
  297. <li class=" tsd-kind-property tsd-parent-kind-interface">
  298. <a href="localstreamoptions.html#screen" class="tsd-kind-icon">screen</a>
  299. </li>
  300. <li class=" tsd-kind-property tsd-parent-kind-interface">
  301. <a href="localstreamoptions.html#screenaudio" class="tsd-kind-icon">screen<wbr>Audio</a>
  302. </li>
  303. <li class=" tsd-kind-property tsd-parent-kind-interface">
  304. <a href="localstreamoptions.html#userid" class="tsd-kind-icon">user<wbr>Id</a>
  305. </li>
  306. <li class=" tsd-kind-property tsd-parent-kind-interface">
  307. <a href="localstreamoptions.html#video" class="tsd-kind-icon">video</a>
  308. </li>
  309. <li class=" tsd-kind-property tsd-parent-kind-interface">
  310. <a href="localstreamoptions.html#videosource" class="tsd-kind-icon">video<wbr>Source</a>
  311. </li>
  312. </ul>
  313. </li>
  314. </ul>
  315. <ul class="after-current">
  316. </ul>
  317. </nav>
  318. </div>
  319. </div>
  320. </div>
  321. <footer class="with-border-bottom">
  322. <div class="container">
  323. <h2>Legend</h2>
  324. <div class="tsd-legend-group">
  325. <ul class="tsd-legend">
  326. <li class="tsd-kind-constructor tsd-parent-kind-class"><span class="tsd-kind-icon">Constructor</span></li>
  327. <li class="tsd-kind-property tsd-parent-kind-class"><span class="tsd-kind-icon">Property</span></li>
  328. <li class="tsd-kind-method tsd-parent-kind-class"><span class="tsd-kind-icon">Method</span></li>
  329. </ul>
  330. <ul class="tsd-legend">
  331. <li class="tsd-kind-property tsd-parent-kind-class tsd-is-inherited"><span class="tsd-kind-icon">Inherited property</span></li>
  332. <li class="tsd-kind-method tsd-parent-kind-class tsd-is-inherited"><span class="tsd-kind-icon">Inherited method</span></li>
  333. </ul>
  334. <ul class="tsd-legend">
  335. <li class="tsd-kind-property tsd-parent-kind-interface"><span class="tsd-kind-icon">Property</span></li>
  336. </ul>
  337. <ul class="tsd-legend">
  338. <li class="tsd-kind-property tsd-parent-kind-class tsd-is-static"><span class="tsd-kind-icon">Static property</span></li>
  339. </ul>
  340. </div>
  341. </div>
  342. </footer>
  343. <div class="container tsd-generator">
  344. <p>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p>
  345. </div>
  346. <div class="overlay"></div>
  347. <script src="../assets/js/main.js"></script>
  348. </body>
  349. </html>