famedlysdk/README.md
2019-10-16 07:47:41 +00:00

1.7 KiB

+++ This SDK is under development and highly experimental +++

famedlysdk

Matrix SDK for the famedly talk app written in dart.

API

The API is documented here: famedly.gitlab.io/famedlysdk

How to use this

  1. Import the sdk
  famedlysdk:
    git:
      url: https://gitlab.com/famedly/famedlysdk.git
import 'package:flutter/material.dart';
import 'package:famedlysdk/famedlysdk.dart';
  1. Create a new client:
Client matrix = Client("HappyChat");

Take a look here for an example store: https://gitlab.com/famedly/famedlysdk/snippets/1904187

Client matrix = Client("HappyChat", store: Store(this));
  1. Connect to a Matrix Homeserver and listen to the streams:
matrix.connection.onLoginStateChanged.stream.listen((bool loginState){ 
  print("LoginState: ${loginState.toString()}");
});

matrix.connection.onEvent.stream.listen((EventUpdate eventUpdate){ 
  print("New event update!");
});

matrix.connection.onRoomUpdate.stream.listen((RoomUpdate eventUpdate){ 
  print("New room update!");
});

final bool serverValid = await matrix.checkServer("https://yourhomeserver.abc");

final bool loginValid = await matrix.login("username", "password");
  1. Send a message to a Room:
final resp = await matrix.connection.jsonRequest(
    type: "PUT",
    action: "/r0/rooms/!fjd823j:example.com/send/m.room.message/$txnId",
    data: {
        "msgtype": "m.text",
        "body": "hello"
    }
);

Development

Regenerating JSON Classes

To regenerate the part files of JSON Classes you need to run this command:

flutter pub run build_runner build