livekit 1.2.1__py3-none-win_arm64.whl

livekit/rtc/_proto/capture_pb2.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: capture.proto
+# Protobuf Python Version: 4.25.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from . import handle_pb2 as handle__pb2
+from . import room_pb2 as room__pb2
+from . import video_frame_pb2 as video__frame__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\rcapture.proto\x12\rlivekit.proto\x1a\x0chandle.proto\x1a\nroom.proto\x1a\x11video_frame.proto\"l\n\x14GstreamerRateControl\x12\x0f\n\x07\x65lement\x18\x01 \x02(\t\x12\x10\n\x08property\x18\x02 \x02(\t\x12\x31\n\x04unit\x18\x03 \x02(\x0e\x32#.livekit.proto.GstreamerBitrateUnit\"\xcd\x01\n\x1aGstreamerVideoSourceConfig\x12\x10\n\x08pipeline\x18\x01 \x02(\t\x12(\n\x05\x63odec\x18\x02 \x01(\x0e\x32\x19.livekit.proto.VideoCodec\x12\x38\n\nresolution\x18\x03 \x01(\x0b\x32$.livekit.proto.VideoSourceResolution\x12\x39\n\x0crate_control\x18\x04 \x01(\x0b\x32#.livekit.proto.GstreamerRateControl\"\x94\x01\n\x18PatternVideoSourceConfig\x12\x38\n\nresolution\x18\x01 \x02(\x0b\x32$.livekit.proto.VideoSourceResolution\x12\x15\n\rframerate_fps\x18\x02 \x02(\r\x12\'\n\x07pattern\x18\x03 \x02(\x0e\x32\x16.livekit.proto.Pattern\"i\n\x16\x43lockVideoSourceConfig\x12\x38\n\nresolution\x18\x01 \x02(\x0b\x32$.livekit.proto.VideoSourceResolution\x12\x15\n\rframerate_fps\x18\x02 \x02(\r\"\xa7\x02\n\x11\x43\x61ptureSourceInfo\x12.\n\x04kind\x18\x01 \x02(\x0e\x32 .livekit.proto.CaptureSourceKind\x12\x38\n\nresolution\x18\x02 \x02(\x0b\x32$.livekit.proto.VideoSourceResolution\x12(\n\x05\x63odec\x18\x03 \x01(\x0e\x32\x19.livekit.proto.VideoCodec\x12G\n\x1brecommended_publish_options\x18\x04 \x02(\x0b\x32\".livekit.proto.TrackPublishOptions\x12\x35\n\x0cvideo_source\x18\x05 \x02(\x0b\x32\x1f.livekit.proto.OwnedVideoSource\"s\n\x12OwnedCaptureSource\x12-\n\x06handle\x18\x01 \x02(\x0b\x32\x1d.livekit.proto.FfiOwnedHandle\x12.\n\x04info\x18\x02 \x02(\x0b\x32 .livekit.proto.CaptureSourceInfo\"\xf1\x01\n\x17NewCaptureSourceRequest\x12>\n\tgstreamer\x18\x01 \x01(\x0b\x32).livekit.proto.GstreamerVideoSourceConfigH\x00\x12:\n\x07pattern\x18\x02 \x01(\x0b\x32\'.livekit.proto.PatternVideoSourceConfigH\x00\x12\x36\n\x05\x63lock\x18\x05 \x01(\x0b\x32%.livekit.proto.ClockVideoSourceConfigH\x00\x12\x18\n\x10request_async_id\x18\x03 \x01(\x04\x42\x08\n\x06\x63onfig\",\n\x18NewCaptureSourceResponse\x12\x10\n\x08\x61sync_id\x18\x01 \x02(\x04\"}\n\x18NewCaptureSourceCallback\x12\x10\n\x08\x61sync_id\x18\x01 \x02(\x04\x12\x0f\n\x05\x65rror\x18\x02 \x01(\tH\x00\x12\x33\n\x06source\x18\x03 \x01(\x0b\x32!.livekit.proto.OwnedCaptureSourceH\x00\x42\t\n\x07message\"-\n\x13StartCaptureRequest\x12\x16\n\x0e\x63\x61pture_handle\x18\x01 \x02(\x04\"%\n\x14StartCaptureResponse\x12\r\n\x05\x65rror\x18\x01 \x01(\t\",\n\x12StopCaptureRequest\x12\x16\n\x0e\x63\x61pture_handle\x18\x01 \x02(\x04\"$\n\x13StopCaptureResponse\x12\r\n\x05\x65rror\x18\x01 \x01(\t\"T\n\x0f\x43\x61ptureFinished\x12\x17\n\x0f\x66rames_captured\x18\x01 \x02(\x04\x12(\n\x04\x65xit\x18\x02 \x02(\x0e\x32\x1a.livekit.proto.CaptureExit\"L\n\x0c\x43\x61ptureError\x12\r\n\x05\x65rror\x18\x01 \x02(\t\x12-\n\x04kind\x18\x02 \x02(\x0e\x32\x1f.livekit.proto.CaptureErrorKind\"\x99\x01\n\x12\x43\x61ptureSourceEvent\x12\x16\n\x0e\x63\x61pture_handle\x18\x01 \x02(\x04\x12\x32\n\x08\x66inished\x18\x02 \x01(\x0b\x32\x1e.livekit.proto.CaptureFinishedH\x00\x12,\n\x05\x65rror\x18\x03 \x01(\x0b\x32\x1b.livekit.proto.CaptureErrorH\x00\x42\t\n\x07message*W\n\x14GstreamerBitrateUnit\x12\x1e\n\x1aGSTREAMER_BITRATE_UNIT_BPS\x10\x00\x12\x1f\n\x1bGSTREAMER_BITRATE_UNIT_KBPS\x10\x01*1\n\x07Pattern\x12\x14\n\x10PATTERN_GRADIENT\x10\x00\x12\x10\n\x0cPATTERN_LOGO\x10\x01*I\n\x11\x43\x61ptureSourceKind\x12\x18\n\x14\x43\x41PTURE_SOURCE_PIXEL\x10\x00\x12\x1a\n\x16\x43\x41PTURE_SOURCE_ENCODED\x10\x01*G\n\x0b\x43\x61ptureExit\x12\x18\n\x14\x43\x41PTURE_EXIT_STOPPED\x10\x00\x12\x1e\n\x1a\x43\x41PTURE_EXIT_END_OF_STREAM\x10\x01*n\n\x10\x43\x61ptureErrorKind\x12\x1d\n\x19\x43\x41PTURE_ERROR_KIND_SOURCE\x10\x00\x12\x1a\n\x16\x43\x41PTURE_ERROR_KIND_RTC\x10\x01\x12\x1f\n\x1b\x43\x41PTURE_ERROR_KIND_PANICKED\x10\x02\x42\x10\xaa\x02\rLiveKit.Proto')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'capture_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\252\002\rLiveKit.Proto'
+  _globals['_GSTREAMERBITRATEUNIT']._serialized_start=1975
+  _globals['_GSTREAMERBITRATEUNIT']._serialized_end=2062
+  _globals['_PATTERN']._serialized_start=2064
+  _globals['_PATTERN']._serialized_end=2113
+  _globals['_CAPTURESOURCEKIND']._serialized_start=2115
+  _globals['_CAPTURESOURCEKIND']._serialized_end=2188
+  _globals['_CAPTUREEXIT']._serialized_start=2190
+  _globals['_CAPTUREEXIT']._serialized_end=2261
+  _globals['_CAPTUREERRORKIND']._serialized_start=2263
+  _globals['_CAPTUREERRORKIND']._serialized_end=2373
+  _globals['_GSTREAMERRATECONTROL']._serialized_start=77
+  _globals['_GSTREAMERRATECONTROL']._serialized_end=185
+  _globals['_GSTREAMERVIDEOSOURCECONFIG']._serialized_start=188
+  _globals['_GSTREAMERVIDEOSOURCECONFIG']._serialized_end=393
+  _globals['_PATTERNVIDEOSOURCECONFIG']._serialized_start=396
+  _globals['_PATTERNVIDEOSOURCECONFIG']._serialized_end=544
+  _globals['_CLOCKVIDEOSOURCECONFIG']._serialized_start=546
+  _globals['_CLOCKVIDEOSOURCECONFIG']._serialized_end=651
+  _globals['_CAPTURESOURCEINFO']._serialized_start=654
+  _globals['_CAPTURESOURCEINFO']._serialized_end=949
+  _globals['_OWNEDCAPTURESOURCE']._serialized_start=951
+  _globals['_OWNEDCAPTURESOURCE']._serialized_end=1066
+  _globals['_NEWCAPTURESOURCEREQUEST']._serialized_start=1069
+  _globals['_NEWCAPTURESOURCEREQUEST']._serialized_end=1310
+  _globals['_NEWCAPTURESOURCERESPONSE']._serialized_start=1312
+  _globals['_NEWCAPTURESOURCERESPONSE']._serialized_end=1356
+  _globals['_NEWCAPTURESOURCECALLBACK']._serialized_start=1358
+  _globals['_NEWCAPTURESOURCECALLBACK']._serialized_end=1483
+  _globals['_STARTCAPTUREREQUEST']._serialized_start=1485
+  _globals['_STARTCAPTUREREQUEST']._serialized_end=1530
+  _globals['_STARTCAPTURERESPONSE']._serialized_start=1532
+  _globals['_STARTCAPTURERESPONSE']._serialized_end=1569
+  _globals['_STOPCAPTUREREQUEST']._serialized_start=1571
+  _globals['_STOPCAPTUREREQUEST']._serialized_end=1615
+  _globals['_STOPCAPTURERESPONSE']._serialized_start=1617
+  _globals['_STOPCAPTURERESPONSE']._serialized_end=1653
+  _globals['_CAPTUREFINISHED']._serialized_start=1655
+  _globals['_CAPTUREFINISHED']._serialized_end=1739
+  _globals['_CAPTUREERROR']._serialized_start=1741
+  _globals['_CAPTUREERROR']._serialized_end=1817
+  _globals['_CAPTURESOURCEEVENT']._serialized_start=1820
+  _globals['_CAPTURESOURCEEVENT']._serialized_end=1973
+# @@protoc_insertion_point(module_scope)

livekit/rtc/_proto/capture_pb2.pyi

@@ -0,0 +1,559 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+Copyright 2026 LiveKit, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import builtins
+import google.protobuf.descriptor
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+from . import handle_pb2
+from . import room_pb2
+import sys
+import typing
+from . import video_frame_pb2
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _GstreamerBitrateUnit:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _GstreamerBitrateUnitEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_GstreamerBitrateUnit.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    GSTREAMER_BITRATE_UNIT_BPS: _GstreamerBitrateUnit.ValueType  # 0
+    GSTREAMER_BITRATE_UNIT_KBPS: _GstreamerBitrateUnit.ValueType  # 1
+
+class GstreamerBitrateUnit(_GstreamerBitrateUnit, metaclass=_GstreamerBitrateUnitEnumTypeWrapper):
+    """Capture sources (livekit-capture)
+
+    A capture source owns a media producer (e.g. a GStreamer pipeline) and the
+    pump that forwards its frames into an RTC video source, so no per-frame
+    FFI traffic is needed. These requests are only served when the FFI server
+    is built with the `capture` feature; otherwise they fail with an error.
+
+    Usage:
+    1. NewCaptureSourceRequest (async): builds and starts the producer,
+       discovers stream settings, and returns an OwnedCaptureSource. Its info
+       embeds an OwnedVideoSource for the existing CreateVideoTrackRequest and
+       the recommended TrackPublishOptions for PublishTrackRequest.
+    2. StartCaptureRequest: starts pumping frames into the RTC source.
+    3. The capture runs until StopCaptureRequest, end of stream, or an error;
+       a CaptureSourceEvent is delivered exactly once when it ends.
+
+    Bitrate unit expected by a GStreamer encoder property.
+    """
+
+GSTREAMER_BITRATE_UNIT_BPS: GstreamerBitrateUnit.ValueType  # 0
+GSTREAMER_BITRATE_UNIT_KBPS: GstreamerBitrateUnit.ValueType  # 1
+global___GstreamerBitrateUnit = GstreamerBitrateUnit
+
+class _Pattern:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _PatternEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_Pattern.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    PATTERN_GRADIENT: _Pattern.ValueType  # 0
+    """Animated color gradient."""
+    PATTERN_LOGO: _Pattern.ValueType  # 1
+    """Bouncing LiveKit logo."""
+
+class Pattern(_Pattern, metaclass=_PatternEnumTypeWrapper):
+    """Test patterns built into livekit-capture."""
+
+PATTERN_GRADIENT: Pattern.ValueType  # 0
+"""Animated color gradient."""
+PATTERN_LOGO: Pattern.ValueType  # 1
+"""Bouncing LiveKit logo."""
+global___Pattern = Pattern
+
+class _CaptureSourceKind:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _CaptureSourceKindEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_CaptureSourceKind.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    CAPTURE_SOURCE_PIXEL: _CaptureSourceKind.ValueType  # 0
+    """Pixel frames, published through the WebRTC encoder."""
+    CAPTURE_SOURCE_ENCODED: _CaptureSourceKind.ValueType  # 1
+    """Pre-encoded access units, published as passthrough."""
+
+class CaptureSourceKind(_CaptureSourceKind, metaclass=_CaptureSourceKindEnumTypeWrapper):
+    """Kind of media a capture source produces."""
+
+CAPTURE_SOURCE_PIXEL: CaptureSourceKind.ValueType  # 0
+"""Pixel frames, published through the WebRTC encoder."""
+CAPTURE_SOURCE_ENCODED: CaptureSourceKind.ValueType  # 1
+"""Pre-encoded access units, published as passthrough."""
+global___CaptureSourceKind = CaptureSourceKind
+
+class _CaptureExit:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _CaptureExitEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_CaptureExit.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    CAPTURE_EXIT_STOPPED: _CaptureExit.ValueType  # 0
+    """Stopped by StopCaptureRequest (or handle disposal)."""
+    CAPTURE_EXIT_END_OF_STREAM: _CaptureExit.ValueType  # 1
+    """The producer reached the end of its stream."""
+
+class CaptureExit(_CaptureExit, metaclass=_CaptureExitEnumTypeWrapper):
+    """Why a capture ended without error."""
+
+CAPTURE_EXIT_STOPPED: CaptureExit.ValueType  # 0
+"""Stopped by StopCaptureRequest (or handle disposal)."""
+CAPTURE_EXIT_END_OF_STREAM: CaptureExit.ValueType  # 1
+"""The producer reached the end of its stream."""
+global___CaptureExit = CaptureExit
+
+class _CaptureErrorKind:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _CaptureErrorKindEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_CaptureErrorKind.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    CAPTURE_ERROR_KIND_SOURCE: _CaptureErrorKind.ValueType  # 0
+    """The capture source failed or violated its contract."""
+    CAPTURE_ERROR_KIND_RTC: _CaptureErrorKind.ValueType  # 1
+    """The RTC video source rejected a frame."""
+    CAPTURE_ERROR_KIND_PANICKED: _CaptureErrorKind.ValueType  # 2
+    """The pump thread panicked."""
+
+class CaptureErrorKind(_CaptureErrorKind, metaclass=_CaptureErrorKindEnumTypeWrapper):
+    """Why a capture ended with an error."""
+
+CAPTURE_ERROR_KIND_SOURCE: CaptureErrorKind.ValueType  # 0
+"""The capture source failed or violated its contract."""
+CAPTURE_ERROR_KIND_RTC: CaptureErrorKind.ValueType  # 1
+"""The RTC video source rejected a frame."""
+CAPTURE_ERROR_KIND_PANICKED: CaptureErrorKind.ValueType  # 2
+"""The pump thread panicked."""
+global___CaptureErrorKind = CaptureErrorKind
+
+@typing.final
+class GstreamerRateControl(google.protobuf.message.Message):
+    """Binding from WebRTC rate-control targets to a GStreamer encoder property."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ELEMENT_FIELD_NUMBER: builtins.int
+    PROPERTY_FIELD_NUMBER: builtins.int
+    UNIT_FIELD_NUMBER: builtins.int
+    element: builtins.str
+    """Name of the encoder element in the pipeline (e.g. `lk_encoder`)."""
+    property: builtins.str
+    """Bitrate property to set on the element (e.g. `bitrate` for x264enc,
+    `target-bitrate` for vp8enc/vp9enc).
+    """
+    unit: global___GstreamerBitrateUnit.ValueType
+    """Unit the property expects."""
+    def __init__(
+        self,
+        *,
+        element: builtins.str | None = ...,
+        property: builtins.str | None = ...,
+        unit: global___GstreamerBitrateUnit.ValueType | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["element", b"element", "property", b"property", "unit", b"unit"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["element", b"element", "property", b"property", "unit", b"unit"]) -> None: ...
+
+global___GstreamerRateControl = GstreamerRateControl
+
+@typing.final
+class GstreamerVideoSourceConfig(google.protobuf.message.Message):
+    """Encoded ingest from a GStreamer pipeline."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PIPELINE_FIELD_NUMBER: builtins.int
+    CODEC_FIELD_NUMBER: builtins.int
+    RESOLUTION_FIELD_NUMBER: builtins.int
+    RATE_CONTROL_FIELD_NUMBER: builtins.int
+    pipeline: builtins.str
+    """GStreamer launch description for the encoded producer pipeline.
+    Must contain `appsink name=lk_appsink`, or leave exactly one encoded
+    video source pad unlinked for the source to attach one to.
+    """
+    codec: video_frame_pb2.VideoCodec.ValueType
+    """Codec expected from the pipeline; inferred from pipeline caps when
+    omitted.
+    """
+    @property
+    def resolution(self) -> video_frame_pb2.VideoSourceResolution:
+        """Encoded frame resolution. When omitted, it is discovered from the
+        pipeline's negotiated caps; when set, the pipeline output is verified
+        against it.
+        """
+
+    @property
+    def rate_control(self) -> global___GstreamerRateControl:
+        """Forwards WebRTC rate-control targets to an encoder element's bitrate
+        property. Without this, the pipeline encodes at a fixed bitrate.
+        """
+
+    def __init__(
+        self,
+        *,
+        pipeline: builtins.str | None = ...,
+        codec: video_frame_pb2.VideoCodec.ValueType | None = ...,
+        resolution: video_frame_pb2.VideoSourceResolution | None = ...,
+        rate_control: global___GstreamerRateControl | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["codec", b"codec", "pipeline", b"pipeline", "rate_control", b"rate_control", "resolution", b"resolution"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["codec", b"codec", "pipeline", b"pipeline", "rate_control", b"rate_control", "resolution", b"resolution"]) -> None: ...
+
+global___GstreamerVideoSourceConfig = GstreamerVideoSourceConfig
+
+@typing.final
+class PatternVideoSourceConfig(google.protobuf.message.Message):
+    """Test pattern rendered on the GPU."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    RESOLUTION_FIELD_NUMBER: builtins.int
+    FRAMERATE_FPS_FIELD_NUMBER: builtins.int
+    PATTERN_FIELD_NUMBER: builtins.int
+    framerate_fps: builtins.int
+    """Output frame rate in frames per second."""
+    pattern: global___Pattern.ValueType
+    """Pattern to render."""
+    @property
+    def resolution(self) -> video_frame_pb2.VideoSourceResolution:
+        """Output resolution."""
+
+    def __init__(
+        self,
+        *,
+        resolution: video_frame_pb2.VideoSourceResolution | None = ...,
+        framerate_fps: builtins.int | None = ...,
+        pattern: global___Pattern.ValueType | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["framerate_fps", b"framerate_fps", "pattern", b"pattern", "resolution", b"resolution"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["framerate_fps", b"framerate_fps", "pattern", b"pattern", "resolution", b"resolution"]) -> None: ...
+
+global___PatternVideoSourceConfig = PatternVideoSourceConfig
+
+@typing.final
+class ClockVideoSourceConfig(google.protobuf.message.Message):
+    """Wall clock with millisecond precision, rendered on the GPU. Shows the
+    local time of the machine that runs the FFI server.
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    RESOLUTION_FIELD_NUMBER: builtins.int
+    FRAMERATE_FPS_FIELD_NUMBER: builtins.int
+    framerate_fps: builtins.int
+    """Output frame rate in frames per second."""
+    @property
+    def resolution(self) -> video_frame_pb2.VideoSourceResolution:
+        """Output resolution."""
+
+    def __init__(
+        self,
+        *,
+        resolution: video_frame_pb2.VideoSourceResolution | None = ...,
+        framerate_fps: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["framerate_fps", b"framerate_fps", "resolution", b"resolution"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["framerate_fps", b"framerate_fps", "resolution", b"resolution"]) -> None: ...
+
+global___ClockVideoSourceConfig = ClockVideoSourceConfig
+
+@typing.final
+class CaptureSourceInfo(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    KIND_FIELD_NUMBER: builtins.int
+    RESOLUTION_FIELD_NUMBER: builtins.int
+    CODEC_FIELD_NUMBER: builtins.int
+    RECOMMENDED_PUBLISH_OPTIONS_FIELD_NUMBER: builtins.int
+    VIDEO_SOURCE_FIELD_NUMBER: builtins.int
+    kind: global___CaptureSourceKind.ValueType
+    codec: video_frame_pb2.VideoCodec.ValueType
+    """Codec produced by the source; encoded sources only."""
+    @property
+    def resolution(self) -> video_frame_pb2.VideoSourceResolution:
+        """Declared or discovered stream resolution."""
+
+    @property
+    def recommended_publish_options(self) -> room_pb2.TrackPublishOptions:
+        """Publish options derived from the source (codec, encoder backend, ...).
+        Merge application options (e.g. track source) over these when calling
+        PublishTrackRequest.
+        """
+
+    @property
+    def video_source(self) -> video_frame_pb2.OwnedVideoSource:
+        """RTC video source fed by this capture source; pass its handle to
+        CreateVideoTrackRequest. Owned by the client like any other handle.
+        """
+
+    def __init__(
+        self,
+        *,
+        kind: global___CaptureSourceKind.ValueType | None = ...,
+        resolution: video_frame_pb2.VideoSourceResolution | None = ...,
+        codec: video_frame_pb2.VideoCodec.ValueType | None = ...,
+        recommended_publish_options: room_pb2.TrackPublishOptions | None = ...,
+        video_source: video_frame_pb2.OwnedVideoSource | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["codec", b"codec", "kind", b"kind", "recommended_publish_options", b"recommended_publish_options", "resolution", b"resolution", "video_source", b"video_source"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["codec", b"codec", "kind", b"kind", "recommended_publish_options", b"recommended_publish_options", "resolution", b"resolution", "video_source", b"video_source"]) -> None: ...
+
+global___CaptureSourceInfo = CaptureSourceInfo
+
+@typing.final
+class OwnedCaptureSource(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    HANDLE_FIELD_NUMBER: builtins.int
+    INFO_FIELD_NUMBER: builtins.int
+    @property
+    def handle(self) -> handle_pb2.FfiOwnedHandle: ...
+    @property
+    def info(self) -> global___CaptureSourceInfo: ...
+    def __init__(
+        self,
+        *,
+        handle: handle_pb2.FfiOwnedHandle | None = ...,
+        info: global___CaptureSourceInfo | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["handle", b"handle", "info", b"info"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["handle", b"handle", "info", b"info"]) -> None: ...
+
+global___OwnedCaptureSource = OwnedCaptureSource
+
+@typing.final
+class NewCaptureSourceRequest(google.protobuf.message.Message):
+    """Create a new capture source from configuration.
+
+    Completes asynchronously with a NewCaptureSourceCallback: construction
+    starts the producer and may wait for its first output to discover stream
+    settings.
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    GSTREAMER_FIELD_NUMBER: builtins.int
+    PATTERN_FIELD_NUMBER: builtins.int
+    CLOCK_FIELD_NUMBER: builtins.int
+    REQUEST_ASYNC_ID_FIELD_NUMBER: builtins.int
+    request_async_id: builtins.int
+    @property
+    def gstreamer(self) -> global___GstreamerVideoSourceConfig: ...
+    @property
+    def pattern(self) -> global___PatternVideoSourceConfig: ...
+    @property
+    def clock(self) -> global___ClockVideoSourceConfig: ...
+    def __init__(
+        self,
+        *,
+        gstreamer: global___GstreamerVideoSourceConfig | None = ...,
+        pattern: global___PatternVideoSourceConfig | None = ...,
+        clock: global___ClockVideoSourceConfig | None = ...,
+        request_async_id: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["clock", b"clock", "config", b"config", "gstreamer", b"gstreamer", "pattern", b"pattern", "request_async_id", b"request_async_id"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["clock", b"clock", "config", b"config", "gstreamer", b"gstreamer", "pattern", b"pattern", "request_async_id", b"request_async_id"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["config", b"config"]) -> typing.Literal["gstreamer", "pattern", "clock"] | None: ...
+
+global___NewCaptureSourceRequest = NewCaptureSourceRequest
+
+@typing.final
+class NewCaptureSourceResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ASYNC_ID_FIELD_NUMBER: builtins.int
+    async_id: builtins.int
+    def __init__(
+        self,
+        *,
+        async_id: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["async_id", b"async_id"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["async_id", b"async_id"]) -> None: ...
+
+global___NewCaptureSourceResponse = NewCaptureSourceResponse
+
+@typing.final
+class NewCaptureSourceCallback(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ASYNC_ID_FIELD_NUMBER: builtins.int
+    ERROR_FIELD_NUMBER: builtins.int
+    SOURCE_FIELD_NUMBER: builtins.int
+    async_id: builtins.int
+    error: builtins.str
+    @property
+    def source(self) -> global___OwnedCaptureSource: ...
+    def __init__(
+        self,
+        *,
+        async_id: builtins.int | None = ...,
+        error: builtins.str | None = ...,
+        source: global___OwnedCaptureSource | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["async_id", b"async_id", "error", b"error", "message", b"message", "source", b"source"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["async_id", b"async_id", "error", b"error", "message", b"message", "source", b"source"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["message", b"message"]) -> typing.Literal["error", "source"] | None: ...
+
+global___NewCaptureSourceCallback = NewCaptureSourceCallback
+
+@typing.final
+class StartCaptureRequest(google.protobuf.message.Message):
+    """Start pumping frames from a capture source into its RTC video source."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CAPTURE_HANDLE_FIELD_NUMBER: builtins.int
+    capture_handle: builtins.int
+    def __init__(
+        self,
+        *,
+        capture_handle: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["capture_handle", b"capture_handle"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["capture_handle", b"capture_handle"]) -> None: ...
+
+global___StartCaptureRequest = StartCaptureRequest
+
+@typing.final
+class StartCaptureResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ERROR_FIELD_NUMBER: builtins.int
+    error: builtins.str
+    def __init__(
+        self,
+        *,
+        error: builtins.str | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["error", b"error"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["error", b"error"]) -> None: ...
+
+global___StartCaptureResponse = StartCaptureResponse
+
+@typing.final
+class StopCaptureRequest(google.protobuf.message.Message):
+    """Signal a running capture to stop after the frame in flight. The terminal
+    CaptureSourceEvent follows shortly. Stopping an already-finished capture
+    is a no-op.
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CAPTURE_HANDLE_FIELD_NUMBER: builtins.int
+    capture_handle: builtins.int
+    def __init__(
+        self,
+        *,
+        capture_handle: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["capture_handle", b"capture_handle"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["capture_handle", b"capture_handle"]) -> None: ...
+
+global___StopCaptureRequest = StopCaptureRequest
+
+@typing.final
+class StopCaptureResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ERROR_FIELD_NUMBER: builtins.int
+    error: builtins.str
+    def __init__(
+        self,
+        *,
+        error: builtins.str | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["error", b"error"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["error", b"error"]) -> None: ...
+
+global___StopCaptureResponse = StopCaptureResponse
+
+@typing.final
+class CaptureFinished(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    FRAMES_CAPTURED_FIELD_NUMBER: builtins.int
+    EXIT_FIELD_NUMBER: builtins.int
+    frames_captured: builtins.int
+    exit: global___CaptureExit.ValueType
+    def __init__(
+        self,
+        *,
+        frames_captured: builtins.int | None = ...,
+        exit: global___CaptureExit.ValueType | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["exit", b"exit", "frames_captured", b"frames_captured"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["exit", b"exit", "frames_captured", b"frames_captured"]) -> None: ...
+
+global___CaptureFinished = CaptureFinished
+
+@typing.final
+class CaptureError(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ERROR_FIELD_NUMBER: builtins.int
+    KIND_FIELD_NUMBER: builtins.int
+    error: builtins.str
+    kind: global___CaptureErrorKind.ValueType
+    def __init__(
+        self,
+        *,
+        error: builtins.str | None = ...,
+        kind: global___CaptureErrorKind.ValueType | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["error", b"error", "kind", b"kind"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["error", b"error", "kind", b"kind"]) -> None: ...
+
+global___CaptureError = CaptureError
+
+@typing.final
+class CaptureSourceEvent(google.protobuf.message.Message):
+    """Delivered exactly once when a started capture ends, regardless of why
+    (stop request, end of stream, or failure).
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CAPTURE_HANDLE_FIELD_NUMBER: builtins.int
+    FINISHED_FIELD_NUMBER: builtins.int
+    ERROR_FIELD_NUMBER: builtins.int
+    capture_handle: builtins.int
+    @property
+    def finished(self) -> global___CaptureFinished: ...
+    @property
+    def error(self) -> global___CaptureError: ...
+    def __init__(
+        self,
+        *,
+        capture_handle: builtins.int | None = ...,
+        finished: global___CaptureFinished | None = ...,
+        error: global___CaptureError | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["capture_handle", b"capture_handle", "error", b"error", "finished", b"finished", "message", b"message"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["capture_handle", b"capture_handle", "error", b"error", "finished", b"finished", "message", b"message"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["message", b"message"]) -> typing.Literal["finished", "error"] | None: ...
+
+global___CaptureSourceEvent = CaptureSourceEvent