Client WebSockets

note

Client WebSockets - 图1

This help topic is in development and will be updated in the future.

Ktor provides Websocket client support for the following engines: CIO, OkHttp, Js. To get more information about the server side, follow this section.

Once connected, client and server WebSockets share the same WebSocketSession interface for communication.

The basic usage to create an HTTP client supporting WebSockets is pretty simple:

  1. val client = HttpClient {
  2.     install(WebSockets)
  3. }

Once created we can perform a request, starting a WebSocketSession:

  1. client.ws(
  2.     method = HttpMethod.Get,
  3.     host = "127.0.0.1",
  4.     port = 8080, path = "/route/path/to/ws"
  5. ) { // this: DefaultClientWebSocketSession
  7.     // Send text frame.
  8.     send("Hello, Text frame")
  10.     // Send text frame.
  11.     send(Frame.Text("Hello World"))
  13.     // Send binary frame.
  14.     send(Frame.Binary(...))
  16.     // Receive frame.
  17.     val frame = incoming.receive()
  18.     when (frame) {
  19.         is Frame.Text -> println(frame.readText())
  20.         is Frame.Binary -> println(frame.readBytes())
  21.     }
  22. }

For more information about the WebSocketSession, check the WebSocketSession page and the API reference.