bump FFI to v0.12.67

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

@@ -18,6 +18,8 @@
 See https://docs.livekit.io/home/client/connect/#installing-the-livekit-sdk for more information.
 """
 
+import warnings
+
 from ._proto import stats_pb2 as stats
 from ._proto.e2ee_pb2 import EncryptionState, EncryptionType, KeyDerivationFunction
 from ._proto.participant_pb2 import (
@@ -37,7 +39,7 @@
     VideoEncoding,
 )
 from ._proto.track_pb2 import (
-    PacketTrailerFeature,
+    FrameMetadataFeature,
     StreamState,
     TrackKind,
     TrackSource,
@@ -134,6 +136,39 @@
 )
 from .frame_processor import FrameProcessor
 
+class _PacketTrailerFeature:
+    """Deprecated alias for :class:`FrameMetadataFeature`.
+
+    "Packet Trailer" was renamed to "Frame Metadata" upstream. This shim keeps
+    the old ``PacketTrailerFeature`` name working, including the old ``PTF_*``
+    value names (which now map to their ``FMF_*`` equivalents), and forwards
+    everything else to :class:`FrameMetadataFeature`. Prefer
+    ``FrameMetadataFeature`` / the ``FMF_*`` values; this will be removed in a
+    future release.
+    """
+
+    _RENAMED = {
+        "PTF_USER_TIMESTAMP": "FMF_USER_TIMESTAMP",
+        "PTF_FRAME_ID": "FMF_FRAME_ID",
+    }
+
+    def __getattr__(self, name: str):
+        renamed = self._RENAMED.get(name)
+        if renamed is not None:
+            warnings.warn(
+                f"PacketTrailerFeature.{name} is deprecated, "
+                f"use FrameMetadataFeature.{renamed} instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            name = renamed
+        return getattr(FrameMetadataFeature, name)
+
+
+# Deprecated: "Packet Trailer" was renamed to "Frame Metadata" upstream.
+# Prefer FrameMetadataFeature; this alias will be removed in a future release.
+PacketTrailerFeature = _PacketTrailerFeature()
+
 __all__ = [
     "ConnectionQuality",
     "ConnectionState",
@@ -148,6 +183,7 @@
     "StreamState",
     "TrackKind",
     "TrackSource",
+    "FrameMetadataFeature",
     "PacketTrailerFeature",
     "ParticipantTrackPermission",
     "VideoBufferType",