# wx.connectSocket ### SocketTask wx.connectSocket(Object object) 創建一個 WebSocket 連接。使用前請注意閱讀[相關說明](https://developers.weixin.qq.com/minigame/dev/tutorial/ability/network.html)。 #### 參數 ##### Object object 屬性類型默認值是否必填說明支持版本urlstring是開發者服務器 wss 接口地址headerObject否HTTP Header，Header 中不能設置 RefererprotocolsArray.<string>否子協議數組>= 1.4.0successfunction否接口調用成功的回調函數failfunction否接口調用失敗的回調函數completefunction否接口調用結束的回調函數（調用成功、失敗都會執行）#### 返回值 ##### SocketTask > 支持版本 >= 1.7.0 WebSocket 任務 #### 并發數 - 1.7.0 及以上版本，最多可以同時存在 5（小游戲）/2（小程序）個 WebSocket 連接。 - 1.7.0 以下版本，一個小程序同時只能有一個 WebSocket 連接，如果當前已存在一個 WebSocket 連接，會自動關閉該連接，并重新創建一個 WebSocket 連接。#### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">wx</span><span class="pun">.</span><span class="pln">connectSocket</span><span class="pun">({</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> url</span><span class="pun">:</span><span class="pln"> </span><span class="str">'wss://example.qq.com'</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> data</span><span class="pun">:{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> x</span><span class="pun">:</span><span class="pln"> </span><span class="str">''</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> y</span><span class="pun">:</span><span class="pln"> </span><span class="str">''</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">},</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> header</span><span class="pun">:{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">'content-type'</span><span class="pun">:</span><span class="pln"> </span><span class="str">'application/json'</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">},</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> protocols</span><span class="pun">:</span><span class="pln"> </span><span class="pun">[</span><span class="str">'protocol1'</span><span class="pun">],</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> method</span><span class="pun">:</span><span class="str">"GET"</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/network/websocket/wx.connectSocket.html>