Update examples and documentation

Author: mobizt

README.md

@@ -6,7 +6,7 @@
 
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/mobizt?logo=github)](https://github.com/sponsors/mobizt)
 
-Revision `2025-01-23T06:30:53Z`
+Revision `2025-01-24T09:51:37Z`
 
 ## Table of Contents
 
@@ -984,13 +984,22 @@ The [CustomAuth](/examples/App/AppInitialization/Async/Callback/CustomAuth/) cla
 CustomAuth::CustomAuth(<TimeStatusCallback>, <api_key>, <client_email>, <project_id>, <private_key>, <user_id>, <scope>, <claims>, <expire>)
 ```
 
-
 ```cpp
 CustomAuth::CustomAuth(<TimeStatusCallback>, <file_config_data>, <api_key>, <user_id>, <scope>, <claims>, <expire>)
 ```
 
+```cpp
+CustomAuth::CustomAuth(<timestamp>, <api_key>, <client_email>, <project_id>, <private_key>, <user_id>, <scope>, <claims>, <expire>)
+```
+
+```cpp
+CustomAuth::CustomAuth(<timestamp>, <file_config_data>, <api_key>, <user_id>, <scope>, <claims>, <expire>)
+```
+
 `<TimeStatusCallback>` The time status callback that provides the UNIX timestamp used to set the issue time and expiration time in the JWT token payload.
 
+`<timestamp>` The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+
 `<file_config_data>` The filesystem data (`file_config_data`) obtained from `FileConfig` class object of service account key file.
 
 `<api_key>` The web API key of the project.
@@ -1029,8 +1038,18 @@ ServiceAuth::ServiceAuth(<TimeStatusCallback>, <client_email>, <project_id>, <pr
 ServiceAuth::ServiceAuth(<TimeStatusCallback>, <file_config_data>, <expire>)
 ```
 
+```cpp
+ServiceAuth::ServiceAuth(<timestamp>, <client_email>, <project_id>, <private_key>, <expire>)
+```
+
+```cpp
+ServiceAuth::ServiceAuth(<timestamp>, <file_config_data>, <expire>)
+```
+
 `<TimeStatusCallback>` The time status callback that provides the UNIX timestamp used to set the issue time and expiration time in the JWT token payload.
 
+`<timestamp>` The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+
 `<file_config_data>` The filesystem data (`file_config_data`) obtained from `FileConfig` class object of service account key file.
 
 `<client_email>` The service account client Email.

examples/App/AppInitialization/Async/Callback/CustomAuth/CustomAuth.ino

@@ -36,6 +36,20 @@
  * <scope> - The OAuth scopes.
  * <claims> - The OAuth claims.
  * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
+ * 
+ *  3.------------------------
+ *
+ * CustomAuth::CustomAuth(<timestamp>, <api_key>, <client_email>, <project_id>, <private_key>, <user_id>, <scope>, <claims>, <expire>);
+ *
+ * <timestamp> - The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+ * <api_key> - The web API key of project.
+ * <client_email> - The service account client Email.
+ * <project_id> - The service account project ID.
+ * <private_key> - The service account private key.
+ * <user_id> - The user ID.
+ * <scope> - The OAuth scopes.
+ * <claims> - The OAuth claims.
+ * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
  *
  * NOTE:
  *

examples/App/AppInitialization/Async/Callback/CustomAuthFile/CustomAuthFile.ino

@@ -37,6 +37,21 @@
  * <scope> - The OAuth scopes.
  * <claims> - The OAuth claims.
  * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
+ * 
+  * 3.------------------------
+ *
+ * CustomAuth::CustomAuth(<timestamp>, <file_config_data>, <api_key>, <user_id>, <scope>, <claims>, <expire>);
+ *
+ * <timestamp> - The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+ * <file_config_data> -  The filesystem data (file_config_data) obtained from FileConfig class object of service account key file.
+ * <api_key> - The web API key of project.
+ * <client_email> - The service account client Email.
+ * <project_id> - The service account project ID.
+ * <private_key> - The service account private key.
+ * <user_id> - The user ID.
+ * <scope> - The OAuth scopes.
+ * <claims> - The OAuth claims.
+ * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
  *
  * NOTE:
  *

examples/App/AppInitialization/Async/Callback/ServiceAuth/ServiceAuth.ino

@@ -32,6 +32,16 @@
  * <project_id> - The service account project ID.
  * <private_key> - The service account private key.
  * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
+ * 
+ * 3.------------------------
+ *
+ * ServiceAuth::ServiceAuth(<timestamp>, <client_email>, <project_id>, <private_key>, <expire>);
+ *
+ * <timestamp> - The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+ * <client_email> - The service account client Email.
+ * <project_id> - The service account project ID.
+ * <private_key> - The service account private key.
+ * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
  *
  * NOTE:
  *

examples/App/AppInitialization/Async/Callback/ServiceAuthFile/ServiceAuthFile.ino

@@ -30,6 +30,14 @@
  * <TimeStatusCallback> - The time status callback that provide the UNIX timestamp value used for JWT token signing.
  * <file_config_data> -  The filesystem data (file_config_data) obtained from FileConfig class object of service account key file.
  * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
+ * 
+ * 3.------------------------
+ *
+ * ServiceAuth::ServiceAuth(<timestamp>, <file_config_data>, <expire>);
+ *
+ * <timestamp> - The current UNiX timestamp (seonds since Jan 1, 1970 midnight).
+ * <file_config_data> -  The filesystem data (file_config_data) obtained from FileConfig class object of service account key file.
+ * <expire> - The expiry period in seconds (less than 3600), 3300 is the default value.
  *
  * NOTE:
  *

examples/RealtimeDatabase/Simple/CustomClass/CustomClass.ino

@@ -0,0 +1,89 @@
+#include "MyFirebase.h"
+#include <WiFi.h>
+#include <WiFiClientSecure.h>
+
+#define WIFI_SSID "WIFI_AP"
+#define WIFI_PASSWORD "WIFI_PASSWORD"
+
+#define API_KEY "Web_API_KEY"
+
+#define USER_EMAIL "USER_EMAIL"
+#define USER_PASSWORD "USER_PASSWORD"
+#define DATABASE_URL "URL"
+
+WiFiClientSecure ssl_client1, ssl_client2;
+
+MyFirebase fb;
+int count = 0;
+unsigned long ms = 0;
+
+void setup()
+{
+    Serial.begin(115200);
+
+    WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
+
+    Serial.print("Connecting to Wi-Fi");
+    while (WiFi.status() != WL_CONNECTED)
+    {
+        Serial.print(".");
+        delay(300);
+    }
+    Serial.println();
+    Serial.print("Connected with IP: ");
+    Serial.println(WiFi.localIP());
+    Serial.println();
+
+    Firebase.printf("Firebase Client v%s\n", FIREBASE_CLIENT_VERSION);
+
+    ssl_client1.setInsecure();
+    ssl_client2.setInsecure();
+
+    fb.userBegin(ssl_client1, DATABASE_URL, API_KEY, USER_EMAIL, USER_PASSWORD);
+
+    fb.beginStream(ssl_client2, "/test/string");
+}
+
+void loop()
+{
+    if (fb.ready() && (ms == 0 || millis() - ms > 20000))
+    {
+        ms = millis();
+
+        count++;
+
+        Serial.println("Setting the string value...");
+        fb.setString("/test/string", "Hello " + String(count));
+
+        Serial.println("Getting the string value...");
+        Serial.println(fb.getString("/test/string"));
+    }
+
+    if (fb.available())
+    {
+        if (fb.isEvent())
+            Serial.printf("Event task: %s, msg: %s, code: %d\n", fb.taskId().c_str(), fb.eventString().c_str(), fb.eventCode());
+
+        if (fb.isDebug())
+            Serial.printf("Debug task: %s, msg: %s\n", fb.taskId().c_str(), fb.debugString().c_str());
+
+        if (fb.isError())
+            Serial.printf("Error task: %s, msg: %s, code: %d\n", fb.taskId().c_str(), fb.errorString().c_str(), fb.errorCode());
+
+        if (fb.isPayload())
+        {
+            if (fb.isStream())
+            {
+                Serial.println("---------------------------");
+                Serial.println("Stream data...");
+                Serial.printf("task: %s\n", fb.taskId().c_str());
+                Serial.printf("event: %s\n", fb.StreamEvent().c_str());
+                Serial.printf("path: %s\n", fb.StreamDataPath().c_str());
+                Serial.printf("data: %s\n", fb.StreamData().c_str());
+                Serial.printf("type: %d\n", fb.StreamDataType());
+            }
+            else
+                Serial.printf("task: %s, payload: %s\n", fb.taskId().c_str(), fb.payload().c_str());
+        }
+    }
+}