github.com/livekit/protocol@v1.16.1-0.20240517185851-47e4c6bba773/protobufs/rpc/egress.proto (about)

     1  // Copyright 2023 LiveKit, Inc.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //     http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  syntax = "proto3";
    16  
    17  package rpc;
    18  
    19  option go_package = "github.com/livekit/protocol/rpc";
    20  
    21  import "options.proto";
    22  import "livekit_egress.proto";
    23  
    24  service EgressInternal {
    25    rpc StartEgress(StartEgressRequest) returns (livekit.EgressInfo) {
    26      option (psrpc.options).affinity_func = true;
    27      option (psrpc.options).topics = true;
    28    };
    29    rpc ListActiveEgress(ListActiveEgressRequest) returns (ListActiveEgressResponse) {
    30      option (psrpc.options).multi = true;
    31      option (psrpc.options).topics = true;
    32    }
    33  }
    34  
    35  service EgressHandler {
    36    rpc UpdateStream(livekit.UpdateStreamRequest) returns (livekit.EgressInfo) {
    37      option (psrpc.options).topics = true;
    38    }
    39    rpc StopEgress(livekit.StopEgressRequest) returns (livekit.EgressInfo) {
    40      option (psrpc.options).topics = true;
    41    }
    42  }
    43  
    44  message StartEgressRequest {
    45    // request metadata
    46    string egress_id = 1;
    47  
    48    // request
    49    oneof request {
    50      livekit.RoomCompositeEgressRequest room_composite = 5;
    51      livekit.WebEgressRequest web = 11;
    52      livekit.ParticipantEgressRequest participant = 13;
    53      livekit.TrackCompositeEgressRequest track_composite = 6;
    54      livekit.TrackEgressRequest track = 7;
    55    }
    56  
    57    // connection info
    58    string room_id = 3;
    59    string token = 8;
    60    string ws_url = 9;
    61  }
    62  
    63  message ListActiveEgressRequest {}
    64  
    65  message ListActiveEgressResponse {
    66    repeated string egress_ids = 1;
    67  }