要指定https在你的socketURL參數中.
convenience init(socketURL: NSURL, options: NSDictionary?)
同上, 但是為了ObjC準備,使用字典.
Options
所有關于SocketIOClientOption的設置.如果是ObjC,轉換名字lowerCamelCase.
case ConnectParams([String: AnyObject]) // 通過字典內容連接
case Cookies([NSHTTPCookie]) // An array of NSHTTPCookies. Passed during the handshake. Default is nil.
case DoubleEncodeUTF8(Bool) // Whether or not to double encode utf8. If using the node based server this should be true. Default is true.
case ExtraHeaders([String: String]) // 添加自定義請求頭初始化來請求, 默認為nil
case ForcePolling(Bool) // 是否使用 xhr-polling. Default is `false`
case ForceNew(Bool) // 將為每個連接創建一個新的connect, 如果你在重新連接時有bug時使用.
case ForceWebsockets(Bool) // 是否使用 WebSockets. Default is `false`
case HandleQueue(dispatch_queue_t) // 調度handle的運行隊列. Default is the main queue.
case Log(Bool) // 是否打印調試信息. Default is false.
case Logger(SocketLogger) // 可自定義SocketLogger調試日志.默認是系統的.
case Nsp(String) // 如果使用命名空間連接. Must begin with /. Default is `/`
case Path(String) // 如果服務器使用一個自定義路徑. 例如: `"/swift/"`. Default is `""`
case Reconnects(Bool) // 是否重新連接服務器失敗. Default is `true`
case ReconnectAttempts(Int) // 重新連接多少次. Default is `-1` (無限次)
case ReconnectWait(Int) // 等待重連時間. Default is `10`
case SessionDelegate(NSURLSessionDelegate) // NSURLSessionDelegate 底層引擎設置. 如果你需要處理自簽名證書. Default is nil.
case Secure(Bool) // 如果連接要使用TLS. Default is false.
case SelfSigned(Bool) // WebSocket.selfSignedSSL設置 (Don't do this, iOS will yell at you)
case VoipEnabled(Bool) // 如果你的客戶端使用VoIP服務,只有用這個選項,Default is false
方法
on(event: String, callback: NormalCallback) -> NSUUID // 給一個事件添加一個句柄. Items are passed by an array. 可以發送ack請求. 例如,返回一個唯一ID.
once(event: String, callback: NormalCallback) -> NSUUID // 同上,但只執行一次.
onAny(callback:((event: String, items: AnyObject?)) -> Void) //可以給所有事件添加一個句柄. event可以接收任何事件.
emit(event: String, _ items: AnyObject...) // 發送一個或多條消息.
emit(event: String, withItems items: [AnyObject]) // emit for Objective-C
emitWithAck(event: String, _ items: AnyObject...) -> (timeoutAfter: UInt64, callback: (NSArray?) -> Void) -> Void // 給服務器發送一個ack確認請求. 返回一個函數,你可以用它添加一個句柄. 注意: 直到你調用這個返回函數,才會發送消息
emitWithAck(event: String, withItems items: [AnyObject]) -> (UInt64, (NSArray?) -> Void) -> Void // 同上,為Objective-C準備的
connect() // 建立一個連接到服務器. 連接成功會觸發 "connect"事件
connect(timeoutAfter timeoutAfter: Int, withTimeoutHandler handler: (() -> Void)?) // 連接到服務器. 如果連接超時,會調用handle
disconnect() // Closes the socket. 重開一個斷開連接的socket還沒完全測試.
reconnect() // Causes the client to reconnect to the server.
joinNamespace(namespace: String) - Causes the client to join namespace. 不應該被調用,除非你手動改變命名空間.
leaveNamespace() // Causes the client to leave the nsp and go back to '/'
off(event: String) - Removes all event handlers for event.
off(id id: NSUUID) - Removes the event that corresponds to id.
removeAllHandlers() - Removes all handlers.
客戶端的事件
connect – 當成功連接時Emitted
disconnect – 當連接斷開Emitted
error – 發送錯誤時Emitted
reconnect – 當開始重連時Emitted
reconnectAttempt – 當嘗試重連時Emitted
