support for track subscription permissions

Author: davidzhao

examples/publish_hue.py

@@ -52,6 +52,28 @@ async def main(room: rtc.Room):
 
     asyncio.ensure_future(draw_color_cycle(source))
 
+    # uncomment the below to test Track Subscription Permissions
+    # https://docs.livekit.io/home/client/tracks/publish/#subscription-permissions
+    # await asyncio.sleep(10)
+
+    # logging.info(
+    #     "setting track subscription permissions to False, no one can subscribe to the track"
+    # )
+    # room.local_participant.set_track_subscription_permissions(False)
+
+    # await asyncio.sleep(10)
+
+    # logging.info("allowing user to subscribe to the track")
+    # room.local_participant.set_track_subscription_permissions(
+    #     False,
+    #     participant_permissions=[
+    #         rtc.ParticipantTrackPermission(
+    #             participant_identity="allowed-user-identity",
+    #             allow_all=True,
+    #         )
+    #     ],
+    # )
+
 
 async def draw_color_cycle(source: rtc.VideoSource):
     argb_frame = bytearray(WIDTH * HEIGHT * 4)

livekit-rtc/livekit/rtc/__init__.py

@@ -27,7 +27,12 @@
     TrackPublishOptions,
     VideoEncoding,
 )
-from ._proto.track_pb2 import StreamState, TrackKind, TrackSource
+from ._proto.track_pb2 import (
+    StreamState,
+    TrackKind,
+    TrackSource,
+    ParticipantTrackPermission,
+)
 from ._proto.video_frame_pb2 import VideoBufferType, VideoCodec, VideoRotation
 from .audio_frame import AudioFrame
 from .audio_source import AudioSource
@@ -97,6 +102,7 @@
     "StreamState",
     "TrackKind",
     "TrackSource",
+    "ParticipantTrackPermission",
     "VideoBufferType",
     "VideoRotation",
     "stats",