bump FFI to v0.12.67

Bumps the rust-sdks submodule from livekit-ffi v0.12.65 to v0.12.67.

Upstream renamed "Packet Trailer" to "Frame Metadata"
(livekit/rust-sdks#1179), so update the hand-written wrapper, exports,
examples, and tests to the new names:
  - PacketTrailerFeature -> FrameMetadataFeature
  - PTF_USER_TIMESTAMP/PTF_FRAME_ID -> FMF_USER_TIMESTAMP/FMF_FRAME_ID
  - packet_trailer_features -> frame_metadata_features

The generated _proto stubs are regenerated by CI on the PR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: chenghao-mou

examples/local_video/publisher.py

@@ -108,12 +108,12 @@ def _open_camera(args: argparse.Namespace) -> tuple[cv2.VideoCapture, int, int]:
     return capture, width, height
 
 
-def _packet_trailer_features(args: argparse.Namespace) -> list[int]:
+def _frame_metadata_features(args: argparse.Namespace) -> list[int]:
     features = []
     if args.attach_timestamp:
-        features.append(rtc.PacketTrailerFeature.PTF_USER_TIMESTAMP)
+        features.append(rtc.FrameMetadataFeature.FMF_USER_TIMESTAMP)
     if args.attach_frame_id:
-        features.append(rtc.PacketTrailerFeature.PTF_FRAME_ID)
+        features.append(rtc.FrameMetadataFeature.FMF_FRAME_ID)
     return features
 
 
@@ -224,13 +224,13 @@ async def run(args: argparse.Namespace, stop_event: asyncio.Event) -> None:
                 max_framerate=args.fps,
                 max_bitrate=3_000_000,
             ),
-            packet_trailer_features=_packet_trailer_features(args),
+            frame_metadata_features=_frame_metadata_features(args),
         )
         publication = await room.local_participant.publish_track(track, options)
         logging.info(
-            "published camera track %s with packet trailer features %s",
+            "published camera track %s with frame metadata features %s",
             publication.sid,
-            list(publication.packet_trailer_features),
+            list(publication.frame_metadata_features),
         )
 
         await _capture_loop(args, capture, source, width, height, stop_event)

examples/local_video/subscriber.py

@@ -176,7 +176,7 @@ def _feature_names(features: list[int]) -> str:
     names = []
     for feature in features:
         try:
-            names.append(rtc.PacketTrailerFeature.Name(feature))
+            names.append(rtc.FrameMetadataFeature.Name(feature))
         except ValueError:
             names.append(str(feature))
     return ", ".join(names) or "none"
@@ -309,10 +309,10 @@ def on_track_unpublished(
             active_publication_sid = subscribed.publication.sid
             active_track_gone = asyncio.Event()
             logging.info(
-                "subscribed to %s from %s with packet trailer features: %s",
+                "subscribed to %s from %s with frame metadata features: %s",
                 subscribed.publication.sid,
                 subscribed.participant.identity,
-                _feature_names(list(subscribed.publication.packet_trailer_features)),
+                _feature_names(list(subscribed.publication.frame_metadata_features)),
             )
 
             video_stream = rtc.VideoStream.from_track(

livekit-rtc/livekit/rtc/__init__.py

@@ -37,7 +37,7 @@
     VideoEncoding,
 )
 from ._proto.track_pb2 import (
-    PacketTrailerFeature,
+    FrameMetadataFeature,
     StreamState,
     TrackKind,
     TrackSource,
@@ -148,7 +148,7 @@
     "StreamState",
     "TrackKind",
     "TrackSource",
-    "PacketTrailerFeature",
+    "FrameMetadataFeature",
     "ParticipantTrackPermission",
     "VideoBufferType",
     "VideoRotation",

livekit-rtc/livekit/rtc/track_publication.py

@@ -80,8 +80,8 @@ def audio_features(self) -> List[proto_track.AudioTrackFeature.ValueType]:
         return list(self._info.audio_features)
 
     @property
-    def packet_trailer_features(self) -> List[proto_track.PacketTrailerFeature.ValueType]:
-        return list(self._info.packet_trailer_features)
+    def frame_metadata_features(self) -> List[proto_track.FrameMetadataFeature.ValueType]:
+        return list(self._info.frame_metadata_features)
 
 
 class LocalTrackPublication(TrackPublication):

livekit-rtc/rust-sdks

@@ -144,9 +144,9 @@ def on_track_subscribed(
 
 @pytest.mark.asyncio
 @skip_if_no_credentials()  # type: ignore[untyped-decorator]
-async def test_video_packet_trailer_metadata() -> None:
-    """Test that packet trailer metadata can be sent and received on video frames."""
-    room_name = unique_room_name("test-video-packet-trailer")
+async def test_video_frame_metadata() -> None:
+    """Test that frame metadata can be sent and received on video frames."""
+    room_name = unique_room_name("test-video-frame-metadata")
     url = os.getenv("LIVEKIT_URL")
     assert url is not None
 
@@ -184,21 +184,21 @@ def on_track_subscribed(
         frame_width, frame_height = 320, 240
         source = rtc.VideoSource(frame_width, frame_height)
         track = rtc.LocalVideoTrack.create_video_track("metadata-video", source)
-        packet_trailer_features = [
-            rtc.PacketTrailerFeature.PTF_USER_TIMESTAMP,
-            rtc.PacketTrailerFeature.PTF_FRAME_ID,
+        frame_metadata_features = [
+            rtc.FrameMetadataFeature.FMF_USER_TIMESTAMP,
+            rtc.FrameMetadataFeature.FMF_FRAME_ID,
         ]
         options = rtc.TrackPublishOptions(
             source=rtc.TrackSource.SOURCE_CAMERA,
-            packet_trailer_features=packet_trailer_features,
+            frame_metadata_features=frame_metadata_features,
         )
         publication = await publisher_room.local_participant.publish_track(track, options)
 
-        assert publication.packet_trailer_features == packet_trailer_features
+        assert publication.frame_metadata_features == frame_metadata_features
         await asyncio.wait_for(track_subscribed_event.wait(), timeout=5.0)
         assert subscribed_track is not None
         assert subscribed_publication is not None
-        assert subscribed_publication.packet_trailer_features == packet_trailer_features
+        assert subscribed_publication.frame_metadata_features == frame_metadata_features
 
         video_stream = rtc.VideoStream.from_track(track=subscribed_track, capacity=1)
         frame = rtc.VideoFrame(
@@ -255,15 +255,15 @@ def on_reconnected() -> None:
 
         source = rtc.VideoSource(2, 2)
         track = rtc.LocalVideoTrack.create_video_track("republish-video", source)
-        packet_trailer_features = [
-            rtc.PacketTrailerFeature.PTF_USER_TIMESTAMP,
-            rtc.PacketTrailerFeature.PTF_FRAME_ID,
+        frame_metadata_features = [
+            rtc.FrameMetadataFeature.FMF_USER_TIMESTAMP,
+            rtc.FrameMetadataFeature.FMF_FRAME_ID,
         ]
         publication = await room.local_participant.publish_track(
             track,
             rtc.TrackPublishOptions(
                 source=rtc.TrackSource.SOURCE_CAMERA,
-                packet_trailer_features=packet_trailer_features,
+                frame_metadata_features=frame_metadata_features,
             ),
         )
         previous_sid = publication.sid
@@ -282,7 +282,7 @@ def on_reconnected() -> None:
 
         assert publication.sid != previous_sid
         assert previous_sid not in room.local_participant.track_publications
-        assert publication.packet_trailer_features == packet_trailer_features
+        assert publication.frame_metadata_features == frame_metadata_features
 
     finally:
         if source is not None:

tests/rtc/test_e2e.py

@@ -22,7 +22,7 @@
 def _publication_info(
     sid: str,
     *,
-    packet_trailer_features: list[proto_track.PacketTrailerFeature.ValueType] | None = None,
+    frame_metadata_features: list[proto_track.FrameMetadataFeature.ValueType] | None = None,
 ) -> proto_track.TrackPublicationInfo:
     return proto_track.TrackPublicationInfo(
         sid=sid,
@@ -36,45 +36,45 @@ def _publication_info(
         muted=False,
         remote=False,
         encryption_type=proto_e2ee.NONE,
-        packet_trailer_features=packet_trailer_features or [],
+        frame_metadata_features=frame_metadata_features or [],
     )
 
 
 def _owned_publication(
     sid: str,
     *,
-    packet_trailer_features: list[proto_track.PacketTrailerFeature.ValueType] | None = None,
+    frame_metadata_features: list[proto_track.FrameMetadataFeature.ValueType] | None = None,
 ) -> proto_track.OwnedTrackPublication:
     return proto_track.OwnedTrackPublication(
         handle=proto_handle.FfiOwnedHandle(id=0),
-        info=_publication_info(sid, packet_trailer_features=packet_trailer_features),
+        info=_publication_info(sid, frame_metadata_features=frame_metadata_features),
     )
 
 
-def test_packet_trailer_symbols_are_exported() -> None:
+def test_frame_metadata_symbols_are_exported() -> None:
     metadata = rtc.FrameMetadata(user_timestamp=123, frame_id=7)
 
-    assert rtc.PacketTrailerFeature.PTF_USER_TIMESTAMP == proto_track.PTF_USER_TIMESTAMP
-    assert rtc.PacketTrailerFeature.PTF_FRAME_ID == proto_track.PTF_FRAME_ID
+    assert rtc.FrameMetadataFeature.FMF_USER_TIMESTAMP == proto_track.FMF_USER_TIMESTAMP
+    assert rtc.FrameMetadataFeature.FMF_FRAME_ID == proto_track.FMF_FRAME_ID
     assert metadata.HasField("user_timestamp")
     assert metadata.HasField("frame_id")
 
 
 @pytest.mark.asyncio
-async def test_track_publication_exposes_packet_trailer_features() -> None:
+async def test_track_publication_exposes_frame_metadata_features() -> None:
     publication = rtc.LocalTrackPublication(
         _owned_publication(
             "TR_OLD",
-            packet_trailer_features=[
-                proto_track.PTF_USER_TIMESTAMP,
-                proto_track.PTF_FRAME_ID,
+            frame_metadata_features=[
+                proto_track.FMF_USER_TIMESTAMP,
+                proto_track.FMF_FRAME_ID,
             ],
         )
     )
 
-    assert publication.packet_trailer_features == [
-        proto_track.PTF_USER_TIMESTAMP,
-        proto_track.PTF_FRAME_ID,
+    assert publication.frame_metadata_features == [
+        proto_track.FMF_USER_TIMESTAMP,
+        proto_track.FMF_FRAME_ID,
     ]
 
 
@@ -140,7 +140,7 @@ async def test_local_track_republished_updates_existing_publication() -> None:
     publication = rtc.LocalTrackPublication(
         _owned_publication(
             "TR_OLD",
-            packet_trailer_features=[proto_track.PTF_USER_TIMESTAMP],
+            frame_metadata_features=[proto_track.FMF_USER_TIMESTAMP],
         )
     )
     # Build a real Track via __new__ (bypassing FFI) so the republish handler's
@@ -161,9 +161,9 @@ async def test_local_track_republished_updates_existing_publication() -> None:
                 previous_sid="TR_OLD",
                 info=_publication_info(
                     "TR_NEW",
-                    packet_trailer_features=[
-                        proto_track.PTF_USER_TIMESTAMP,
-                        proto_track.PTF_FRAME_ID,
+                    frame_metadata_features=[
+                        proto_track.FMF_USER_TIMESTAMP,
+                        proto_track.FMF_FRAME_ID,
                     ],
                 ),
             ),
@@ -173,7 +173,7 @@ async def test_local_track_republished_updates_existing_publication() -> None:
     assert "TR_OLD" not in local_participant.track_publications
     assert local_participant.track_publications["TR_NEW"] is publication
     assert publication.sid == "TR_NEW"
-    assert publication.packet_trailer_features == [
-        proto_track.PTF_USER_TIMESTAMP,
-        proto_track.PTF_FRAME_ID,
+    assert publication.frame_metadata_features == [
+        proto_track.FMF_USER_TIMESTAMP,
+        proto_track.FMF_FRAME_ID,
     ]