cleanup changes godot->sdk add docs

Author: toger5

godot/README.md

@@ -43,15 +43,5 @@
     <% if (packageType !== "full") { %>
     <div id="root"></div>
     <% } %>
-
-    <!-- Godot export -->
-    <% if (packageType === "godot") { %>
-    <canvas id="canvas"></canvas>
-    <script src="$GODOT_URL"></script>
-    <script>
-      var engine = new Engine($GODOT_CONFIG);
-      engine.startGame();
-    </script>
-    <% } %>
   </body>
 </html>

godot/favicon.ico

@@ -13,8 +13,8 @@
     "build:embedded": "yarn build:full --config vite-embedded.config.js",
     "build:embedded:production": "yarn build:embedded",
     "build:embedded:development": "yarn build:embedded --mode development",
-    "build:godot": "yarn build:full --config vite-godot.config.js",
-    "build:godot:development": "yarn build:godot --mode development",
+    "build:sdk": "yarn build:full --config vite-sdk.config.js",
+    "build:sdk:development": "yarn build:sdk --mode development",
     "serve": "vite preview",
     "prettier:check": "prettier -c .",
     "prettier:format": "prettier -w .",

index.html

@@ -0,0 +1,33 @@
+# SDK mode
+EC can be build in sdk mode. This will result in a compiled js file that can be imported in very simple webapps.
+
+It allows to use matrixRTC in combination with livekit without relying on element call.
+
+This is done by instantiating the call view model and exposing some useful behaviors (observables) and methods.
+
+This folder contains an example index.html file that showcases the sdk in use (hosted on localhost:8123 with a webserver ellowing cors (for example `npx serve -l 81234 --cors`)) as a godot engine HTML export template.
+
+## Widgets
+The sdk mode is particularly interesting to be used in widgets where you do not need to pay attention to matrix login/cs api ...
+To create a widget see the example index.html file in this folder. And add it to EW via:
+`/addwidget <widgetUrl>`  (see **url parameters** for more details on `<widgetUrl>`)
+
+### url parameters
+```
+widgetId = $matrix_widget_id
+perParticipantE2EE = true
+userId = $matrix_user_id
+deviceId = $org.matrix.msc3819.matrix_device_id
+baseUrl = $org.matrix.msc4039.matrix_base_url
+```
+`
+parentUrl = // will be inserted automatically
+`
+
+Full template use as `<widgetUrl>`:
+
+```
+http://localhost:3000?widgetId=$matrix_widget_id&perParticipantE2EE=true&userId=$matrix_user_id&deviceId=$org.matrix.msc3819.matrix_device_id&baseUrl=$org.matrix.msc4039.matrix_base_url&roomId=$matrix_room_id
+```
+
+the `$` prefixed variables will be replaced by EW on widget instantiation.  (e.g. `$matrix_user_id` -> `@user:example.com` (url encoding will also be applied automatically by EW) -> `%40user%3Aexample.com`)

package.json

@@ -5,6 +5,10 @@ SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
 Please see LICENSE in the repository root for full details.
 */
 
+/**
+ * This file contains helper functions and types for the MatrixRTC SDK.
+ */
+
 import { logger as rootLogger } from "matrix-js-sdk/lib/logger";
 import { scan } from "rxjs";
 

sdk/README.md

@@ -4,8 +4,8 @@
     <title>Godot MatrixRTC Widget</title>
     <meta charset="utf-8" />
     <script type="module">
-      // TODO use the url where the matrixrtc-ec-godot.js file from dist is hosted
-      import { createMatrixRTCSdk } from "http://localhost:8123/matrixrtc-ec-godot.js";
+      // TODO use the url where the matrixrtc-sdk.js file from dist is hosted
+      import { createMatrixRTCSdk } from "http://localhost:8123/matrixrtc-sdk.js";
 
       try {
         console.log("Hello from index.html");

godot/helper.ts sdk/helper.tsgodot/helper.ts renamed to sdk/helper.ts

@@ -5,7 +5,19 @@ SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
 Please see LICENSE in the repository root for full details.
 */
 
-// import { type InitResult } from "../src/ClientContext";
+/**
+ * This file is the entrypoint for the sdk build of element call: `yarn build:sdk`
+ * use in widgets.
+ * It exposes the `createMatrixRTCSdk` which creates the `MatrixRTCSdk` interface (see below) that
+ * can be used to join a rtc session and exchange realtime data.
+ * It takes care of all the tricky bits:
+ *  - sending delayed events
+ *  - finding the right sfu
+ *  - handling the media stream
+ *  - sending join/leave state or sticky events
+ *  - setting up encryption and scharing keys
+ */
+
 import { map, type Observable, of, Subject, switchMap, tap } from "rxjs";
 import { MatrixRTCSessionEvent } from "matrix-js-sdk/lib/matrixrtc";
 import { type TextStreamInfo } from "livekit-client/dist/src/room/types";
@@ -40,6 +52,7 @@ interface MatrixRTCSdk {
   members$: Behavior<MatrixLivekitMember[]>;
   sendData?: (data: unknown) => Promise<void>;
 }
+
 export async function createMatrixRTCSdk(): Promise<MatrixRTCSdk> {
   logger.info("Hello");
   const client = await widget.client;

godot/index.html sdk/index.htmlgodot/index.html renamed to sdk/index.html

@@ -262,8 +262,8 @@ export interface CallViewModel {
   participantCount$: Behavior<number>;
   /** Participants sorted by livekit room so they can be used in the audio rendering */
   livekitRoomItems$: Behavior<LivekitRoomItem[]>;
-  /** use the layout instead, this is just for the godot export. */
   userMedia$: Behavior<UserMedia[]>;
+  /** use the layout instead, this is just for the sdk export. */
   matrixLivekitMembers$: Behavior<MatrixLivekitMember[]>;
   localMatrixLivekitMember$: Behavior<LocalMatrixLivekitMember | null>;
   /** List of participants raising their hand */

godot/main.ts sdk/main.tsgodot/main.ts renamed to sdk/main.ts

@@ -54,7 +54,7 @@
     "./src/**/*.ts",
     "./src/**/*.tsx",
     "./playwright/**/*.ts",
-    "./godot/**/*.ts"
+    "./sdk/**/*.ts"
   ],
   "exclude": ["**.test.ts"]
 }