sails_io 0.0.2 icon indicating copy to clipboard operation
sails_io: ^0.0.2 copied to clipboard

Dart/Flutter Websocket Client SDK for communication with Sails from a mobile application.

Dart/Flutter Websocket Client SDK for communication with Sails from a mobile application(or any client running Dart or Flutter)

Usage #

A simple usage example:

import 'package:sails_io/sails_io.dart';
import 'package:socket_io_client/socket_io_client.dart' as socket_io_client;

void main() {
  var io = SailsIOClient(socket_io_client.io(
      'http://example_websocket_url.com?__sails_io_sdk_version=0.11.0',
      socket_io_client.OptionBuilder().setTransports(['websocket']).build()));

  io.socket.onConnect((_) {
    print('Connected');
  });

  io.socket.on('user', (message) {});
  io.socket.onDisconnect((_) => print('disconnected'));

  io.post(
      url: 'http://example_websocket_url.com/chats',
      data: {
        'textContent': 'New chat from sails_io',
        'counterpartId': '464684932623463467'
      },
      cb: (body, jwrResponse) {
        print(body);
        print(jwrResponse.toJSON());
      });
}

The __sails_io_sdk_version query string #

Currently, the Sails websocket server expects that the socket client connecting with it is >= 0.11.0 or it will default to a version of 0.9.0.

To override this notice we are passing the query string to the URL when connecting like so

 var io = SailsIOClient(socket_io_client.io(
      'http://example_websocket_url.com?__sails_io_sdk_version=0.11.0',
      socket_io_client.OptionBuilder().setTransports(['websocket']).build()));

Do note that this is important because even if your socket connects without the string, trying to listen or use the virtual requests i.e io.post or io.get will result in an error on your Sails server saying the version of the SDK is incompatible

Features and bugs #

Please file feature requests and bugs at the issue tracker.

4
likes
130
pub points
73%
popularity

Publisher

verified publisher iconsailscasts.com

Dart/Flutter Websocket Client SDK for communication with Sails from a mobile application.

Homepage

Documentation

API reference

License

Icon for licenses.MIT (LICENSE)

Dependencies

socket_io_client

More

Packages that depend on sails_io