Simple streaming API proposal

[proppy]

I'd like to propose a simple way to handle streaming, instead of having explicit stream methods, it could just an option of begin(), a different variant beginStream or even a FirebaseStream global object.

stream an int value

void setup() {
    FirebaseStream.begin("example.firebaseio.com", "token_or_secret");
}

void loop() {
   if (FirebaseStream.available()) {
     Serial.print("value changed:");
     Serial.println(FirebaseStream.getInt('/path/to/int'));
   }
}

stream a more complex object

void setup() {
    FirebaseStream.begin("example.firebaseio.com", "token_or_secret");
}

void loop() {
  if (FirebaseStream.available()) {
    FirebaseObject obj = FirebaseStream.get('/path/to/object')
    Serial.print("value changed:");
    Serial.println(obj.getFloat("/subpath/to/float););
  }
}

This could also mix well with #160 to stream from a specific path.

void setup() {
    FirebaseStream.begin("example.firebaseio.com", "token_or_secret", '/path/to/object');
}

void loop() {
  if (FirebaseStream.available()) {
    Serial.print("value changed:");
    Serial.println(FirebaseStream.getFloat("/subpath/to/float););
  }
}

[proppy]

We should also add method to check for other type of event:
child_added child_changed child_removed child_moved

[Aylali]

Hi I am curios, did this really easy way of streaming incoming value worked out?

[proppy]

I think we want something like this:

void setup() {
    Firebase.begin();
}

void loop() {
    Firebase.stream('/foo'); # consume one event from the stream
    if (Firebase.error()) { # check for erros
       // ...
    }
    if (Firebase.changed(/'bar')) { # check if /foo/bar changed
        int foo = Firebase.getInt('/bar'); # get foo/bar updated value
    }
}

[adamrabbani]

@proppy
if (Firebase.changed(/'bar')) { # check if /foo/bar changed
int foo = Firebase.getInt('/bar'); # get foo/bar updated value
}
what different size data between .changed and .get ?? same download or not ?
Thanks

[proppy]

@adamrabbani .changed would just return a bool, .get would actually return the data. The event actually get consumed on the .stream call.

[adamrabbani]

@proppy ohh.. i see.. good