Data tracks

.changes/data-tracks

@@ -0,0 +1 @@
+minor type="added" "Data tracks: publish and subscribe to ordered frame streams over a dedicated unreliable channel, with optional schema and frame-encoding metadata"

.github/workflows/ci.yaml

@@ -105,7 +105,11 @@ jobs:
         uses: livekit/dev-server-action@61e2b4dcb170dd3591e0c9b0db3c3fe5db93b500
         with:
           github-token: ${{ github.token }}
-          config: 'room: { departure_timeout: 1 }'
+          config: |
+            room:
+              departure_timeout: 1
+            # Data track schema definitions are stored as participant data blobs.
+            enable_participant_data_blob: true
 
       - uses: maxim-lobanov/setup-xcode@v1
         with:
@@ -243,7 +247,7 @@ jobs:
       # Hard budget for the SDK's uncompressed .app delta, in MB — no tolerance
       # band. Move it deliberately, in the same commit as the change that needs
       # it (the job summary reports the measured value).
-      SIZE_BASELINE_MB: "16"
+      SIZE_BASELINE_MB: "16.5"
     steps:
       - uses: actions/checkout@v7
         with:

AGENTS.md

@@ -9,7 +9,9 @@ Platform destinations: `macOS`, `macOS,variant=Mac Catalyst`, `iOS Simulator`, `
 # Build
 xcodebuild build -scheme LiveKit -destination 'platform=macOS'
 
-# Run tests (requires local server: livekit-server --dev, install via brew install livekit)
+# Run tests (requires local server, install via brew install livekit). Data track schema tests
+# need participant data blobs, which --dev alone leaves off:
+#   printf 'enable_participant_data_blob: true\n' > lk.yaml && livekit-server --dev --config lk.yaml
 xcodebuild test -scheme LiveKit -only-testing LiveKitCoreTests -destination 'platform=macOS'
 
 # Build benchmarks

LiveKitClient.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |spec|
   spec.pod_target_xcconfig = {"SWIFT_PACKAGE_NAME" => "livekit_client_sdk_swift"}
 
   spec.dependency("LiveKitWebRTC", "= 144.7559.13")
-  spec.dependency("LiveKitUniFFI", "= 0.0.6")
+  spec.dependency("LiveKitUniFFI", "= 0.1.8")
 
   spec.resource_bundles = {"Privacy" => ["Sources/LiveKit/PrivacyInfo.xcprivacy"]}
 end

Package.swift

@@ -20,7 +20,7 @@ let package = Package(
     dependencies: [
         // LK-Prefixed Dynamic WebRTC XCFramework
         .package(url: "https://github.com/livekit/webrtc-xcframework.git", exact: "144.7559.13"),
-        .package(url: "https://github.com/livekit/livekit-uniffi-xcframework.git", exact: "0.0.6"),
+        .package(url: "https://github.com/livekit/livekit-uniffi-xcframework.git", exact: "0.1.8"),
         // Test-only: conformance oracle for the nanopb facades.
         .package(url: "https://github.com/apple/swift-protobuf.git", from: "1.31.0"),
         // Only used for DocC generation

Package@swift-6.2.swift

@@ -21,7 +21,7 @@ let package = Package(
     dependencies: [
         // LK-Prefixed Dynamic WebRTC XCFramework
         .package(url: "https://github.com/livekit/webrtc-xcframework.git", exact: "144.7559.13"),
-        .package(url: "https://github.com/livekit/livekit-uniffi-xcframework.git", exact: "0.0.6"),
+        .package(url: "https://github.com/livekit/livekit-uniffi-xcframework.git", exact: "0.1.8"),
         // Test-only: conformance oracle for the nanopb facades.
         .package(url: "https://github.com/apple/swift-protobuf.git", from: "1.31.0"),
         // Only used for DocC generation

Sources/CLiveKitProto/include/livekit_metrics.pb.h

@@ -92,6 +92,9 @@ typedef struct _livekit_MetricsRecordingHeader {
     struct _livekit_MetricsRecordingHeader_RoomTagsEntry *room_tags;
     char *room_name;
     struct _google_protobuf_Timestamp *room_start_time;
+    char *job_id;
+    bool *simulated; /* session is a simulation; the collector skips PII redaction for it unless redaction_enabled is set */
+    bool *redaction_enabled; /* force PII redaction on for this session (only ever enables, never disables) */
 } livekit_MetricsRecordingHeader;
 
 typedef struct _livekit_MetricsRecordingHeader_RoomTagsEntry {
@@ -121,13 +124,13 @@ extern "C" {
 #define livekit_TimeSeriesMetric_init_default    {NULL, NULL, NULL, 0, NULL, NULL}
 #define livekit_MetricSample_init_default        {NULL, NULL, NULL}
 #define livekit_EventMetric_init_default         {NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
-#define livekit_MetricsRecordingHeader_init_default {NULL, NULL, NULL, 0, NULL, NULL, NULL}
+#define livekit_MetricsRecordingHeader_init_default {NULL, NULL, NULL, 0, NULL, NULL, NULL, NULL, NULL, NULL}
 #define livekit_MetricsRecordingHeader_RoomTagsEntry_init_default {NULL, NULL}
 #define livekit_MetricsBatch_init_zero           {NULL, NULL, 0, NULL, 0, NULL, 0, NULL}
 #define livekit_TimeSeriesMetric_init_zero       {NULL, NULL, NULL, 0, NULL, NULL}
 #define livekit_MetricSample_init_zero           {NULL, NULL, NULL}
 #define livekit_EventMetric_init_zero            {NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
-#define livekit_MetricsRecordingHeader_init_zero {NULL, NULL, NULL, 0, NULL, NULL, NULL}
+#define livekit_MetricsRecordingHeader_init_zero {NULL, NULL, NULL, 0, NULL, NULL, NULL, NULL, NULL, NULL}
 #define livekit_MetricsRecordingHeader_RoomTagsEntry_init_zero {NULL, NULL}
 
 /* Field tags (for use in manual encoding/decoding) */
@@ -159,6 +162,9 @@ extern "C" {
 #define livekit_MetricsRecordingHeader_room_tags_tag 5
 #define livekit_MetricsRecordingHeader_room_name_tag 6
 #define livekit_MetricsRecordingHeader_room_start_time_tag 7
+#define livekit_MetricsRecordingHeader_job_id_tag 8
+#define livekit_MetricsRecordingHeader_simulated_tag 9
+#define livekit_MetricsRecordingHeader_redaction_enabled_tag 10
 #define livekit_MetricsRecordingHeader_RoomTagsEntry_key_tag 1
 #define livekit_MetricsRecordingHeader_RoomTagsEntry_value_tag 2
 
@@ -214,7 +220,10 @@ X(a, POINTER,  SINGULAR, UINT64,   duration,          3) \
 X(a, POINTER,  OPTIONAL, MESSAGE,  start_time,        4) \
 X(a, POINTER,  REPEATED, MESSAGE,  room_tags,         5) \
 X(a, POINTER,  SINGULAR, STRING,   room_name,         6) \
-X(a, POINTER,  OPTIONAL, MESSAGE,  room_start_time,   7)
+X(a, POINTER,  OPTIONAL, MESSAGE,  room_start_time,   7) \
+X(a, POINTER,  SINGULAR, STRING,   job_id,            8) \
+X(a, POINTER,  SINGULAR, BOOL,     simulated,         9) \
+X(a, POINTER,  SINGULAR, BOOL,     redaction_enabled,  10)
 #define livekit_MetricsRecordingHeader_CALLBACK NULL
 #define livekit_MetricsRecordingHeader_DEFAULT NULL
 #define livekit_MetricsRecordingHeader_start_time_MSGTYPE google_protobuf_Timestamp