124 lines
2.6 KiB
Go
124 lines
2.6 KiB
Go
// Copyright 2023 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.
|
|
|
|
package bwe
|
|
|
|
import (
|
|
"fmt"
|
|
"time"
|
|
|
|
"github.com/livekit/livekit-server/pkg/sfu/ccutils"
|
|
"github.com/pion/rtcp"
|
|
)
|
|
|
|
// ------------------------------------------------
|
|
|
|
const (
|
|
DefaultRTT = float64(0.070) // 70 ms
|
|
RTTSmoothingFactor = float64(0.5)
|
|
)
|
|
|
|
// ------------------------------------------------
|
|
|
|
type BWEType int
|
|
|
|
const (
|
|
BWETypeNone BWEType = iota
|
|
BWETypeRemote
|
|
BWETypeSendSide
|
|
)
|
|
|
|
func (b BWEType) String() string {
|
|
switch b {
|
|
case BWETypeNone:
|
|
return "NONE"
|
|
case BWETypeRemote:
|
|
return "REMOTE"
|
|
case BWETypeSendSide:
|
|
return "SEND_SIDE"
|
|
default:
|
|
return fmt.Sprintf("%d", int(b))
|
|
}
|
|
}
|
|
|
|
// ------------------------------------------------
|
|
|
|
type CongestionState int
|
|
|
|
const (
|
|
CongestionStateNone CongestionState = iota
|
|
CongestionStateEarlyWarning
|
|
CongestionStateCongested
|
|
)
|
|
|
|
func (c CongestionState) String() string {
|
|
switch c {
|
|
case CongestionStateNone:
|
|
return "NONE"
|
|
case CongestionStateEarlyWarning:
|
|
return "EARLY_WARNING"
|
|
case CongestionStateCongested:
|
|
return "CONGESTED"
|
|
default:
|
|
return fmt.Sprintf("%d", int(c))
|
|
}
|
|
}
|
|
|
|
// ------------------------------------------------
|
|
|
|
type BWE interface {
|
|
Type() BWEType
|
|
|
|
SetBWEListener(bweListner BWEListener)
|
|
|
|
Reset()
|
|
|
|
HandleREMB(
|
|
receivedEstimate int64,
|
|
expectedBandwidthUsage int64,
|
|
sentPackets uint32,
|
|
repeatedNacks uint32,
|
|
)
|
|
|
|
// TWCC sequence number
|
|
RecordPacketSendAndGetSequenceNumber(
|
|
atMicro int64,
|
|
size int,
|
|
isRTX bool,
|
|
probeClusterId ccutils.ProbeClusterId,
|
|
isProbe bool,
|
|
) uint16
|
|
|
|
HandleTWCCFeedback(report *rtcp.TransportLayerCC)
|
|
|
|
UpdateRTT(rtt float64)
|
|
|
|
CongestionState() CongestionState
|
|
|
|
CanProbe() bool
|
|
ProbeDuration() time.Duration
|
|
ProbeClusterStarting(pci ccutils.ProbeClusterInfo)
|
|
ProbeClusterDone(pci ccutils.ProbeClusterInfo)
|
|
ProbeClusterIsGoalReached() bool
|
|
ProbeClusterFinalize() (ccutils.ProbeSignal, int64, bool)
|
|
}
|
|
|
|
// ------------------------------------------------
|
|
|
|
type BWEListener interface {
|
|
OnCongestionStateChange(fromState CongestionState, toState CongestionState, estimatedAvailableChannelCapacity int64)
|
|
}
|
|
|
|
// ------------------------------------------------
|