2020-05-12 09:46:20 +02:00
|
|
|
/**
|
|
|
|
* Standalone signaling server for the Nextcloud Spreed app.
|
|
|
|
* Copyright (C) 2017 struktur AG
|
|
|
|
*
|
|
|
|
* @author Joachim Bauch <bauch@struktur.de>
|
|
|
|
*
|
|
|
|
* @license GNU AGPL version 3 or any later version
|
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
package signaling
|
|
|
|
|
|
|
|
import (
|
2020-08-31 13:58:28 +02:00
|
|
|
"context"
|
2020-08-07 10:23:47 +02:00
|
|
|
"fmt"
|
|
|
|
|
2020-08-31 13:07:03 +02:00
|
|
|
"github.com/dlintw/goconf"
|
2020-05-12 09:46:20 +02:00
|
|
|
)
|
|
|
|
|
|
|
|
const (
|
|
|
|
McuTypeJanus = "janus"
|
2020-08-07 10:27:28 +02:00
|
|
|
McuTypeProxy = "proxy"
|
2020-05-12 09:46:20 +02:00
|
|
|
|
|
|
|
McuTypeDefault = McuTypeJanus
|
|
|
|
)
|
|
|
|
|
2020-08-07 10:23:47 +02:00
|
|
|
var (
|
2021-04-26 17:19:39 +02:00
|
|
|
ErrNotConnected = fmt.Errorf("not connected")
|
2020-08-07 10:23:47 +02:00
|
|
|
)
|
|
|
|
|
2021-11-08 12:06:59 +01:00
|
|
|
type MediaType int
|
|
|
|
|
|
|
|
const (
|
|
|
|
MediaTypeAudio MediaType = 1 << 0
|
|
|
|
MediaTypeVideo MediaType = 1 << 1
|
|
|
|
MediaTypeScreen MediaType = 1 << 2
|
|
|
|
)
|
|
|
|
|
2020-05-12 09:46:20 +02:00
|
|
|
type McuListener interface {
|
2020-08-07 10:23:47 +02:00
|
|
|
PublicId() string
|
2020-05-12 09:46:20 +02:00
|
|
|
|
2022-02-10 20:19:25 +01:00
|
|
|
OnUpdateOffer(client McuClient, offer map[string]interface{})
|
|
|
|
|
2020-05-12 09:46:20 +02:00
|
|
|
OnIceCandidate(client McuClient, candidate interface{})
|
|
|
|
OnIceCompleted(client McuClient)
|
|
|
|
|
2022-04-13 03:03:36 +02:00
|
|
|
SubscriberSidUpdated(subscriber McuSubscriber)
|
|
|
|
|
2020-05-12 09:46:20 +02:00
|
|
|
PublisherClosed(publisher McuPublisher)
|
|
|
|
SubscriberClosed(subscriber McuSubscriber)
|
|
|
|
}
|
|
|
|
|
2020-08-12 15:42:11 +02:00
|
|
|
type McuInitiator interface {
|
|
|
|
Country() string
|
|
|
|
}
|
|
|
|
|
2020-05-12 09:46:20 +02:00
|
|
|
type Mcu interface {
|
|
|
|
Start() error
|
|
|
|
Stop()
|
2020-08-31 13:07:03 +02:00
|
|
|
Reload(config *goconf.ConfigFile)
|
2020-05-12 09:46:20 +02:00
|
|
|
|
2020-08-07 10:23:47 +02:00
|
|
|
SetOnConnected(func())
|
|
|
|
SetOnDisconnected(func())
|
|
|
|
|
2020-05-28 16:02:04 +02:00
|
|
|
GetStats() interface{}
|
|
|
|
|
2024-02-27 13:52:59 +01:00
|
|
|
NewPublisher(ctx context.Context, listener McuListener, id string, sid string, streamType StreamType, bitrate int, mediaTypes MediaType, initiator McuInitiator) (McuPublisher, error)
|
2024-04-18 12:47:29 +02:00
|
|
|
NewSubscriber(ctx context.Context, listener McuListener, publisher string, streamType StreamType, initiator McuInitiator) (McuSubscriber, error)
|
|
|
|
}
|
|
|
|
|
2024-04-18 16:48:10 +02:00
|
|
|
// PublisherStream contains the available properties when creating a
|
|
|
|
// remote publisher in Janus.
|
|
|
|
type PublisherStream struct {
|
|
|
|
Mid string `json:"mid"`
|
|
|
|
Mindex int `json:"mindex"`
|
|
|
|
Type string `json:"type"`
|
|
|
|
|
|
|
|
Description string `json:"description,omitempty"`
|
|
|
|
Disabled bool `json:"disabled,omitempty"`
|
|
|
|
|
|
|
|
// For types "audio" and "video"
|
|
|
|
Codec string `json:"codec,omitempty"`
|
|
|
|
|
|
|
|
// For type "audio"
|
|
|
|
Stereo bool `json:"stereo,omitempty"`
|
|
|
|
Fec bool `json:"fec,omitempty"`
|
|
|
|
Dtx bool `json:"dtx,omitempty"`
|
|
|
|
|
|
|
|
// For type "video"
|
|
|
|
Simulcast bool `json:"simulcast,omitempty"`
|
|
|
|
Svc bool `json:"svc,omitempty"`
|
|
|
|
|
|
|
|
ProfileH264 string `json:"h264_profile,omitempty"`
|
|
|
|
ProfileVP9 string `json:"vp9_profile,omitempty"`
|
|
|
|
|
|
|
|
ExtIdVideoOrientation int `json:"videoorient_ext_id,omitempty"`
|
|
|
|
ExtIdPlayoutDelay int `json:"playoutdelay_ext_id,omitempty"`
|
|
|
|
}
|
|
|
|
|
2024-04-18 12:47:29 +02:00
|
|
|
type RemotePublisherController interface {
|
|
|
|
PublisherId() string
|
|
|
|
|
|
|
|
StartPublishing(ctx context.Context, publisher McuRemotePublisherProperties) error
|
2024-04-18 16:48:10 +02:00
|
|
|
GetStreams(ctx context.Context) ([]PublisherStream, error)
|
2024-04-18 12:47:29 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
type RemoteMcu interface {
|
|
|
|
NewRemotePublisher(ctx context.Context, listener McuListener, controller RemotePublisherController, streamType StreamType) (McuRemotePublisher, error)
|
|
|
|
NewRemoteSubscriber(ctx context.Context, listener McuListener, publisher McuRemotePublisher) (McuRemoteSubscriber, error)
|
2024-02-27 13:52:59 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
type StreamType string
|
|
|
|
|
|
|
|
const (
|
|
|
|
StreamTypeAudio StreamType = "audio"
|
|
|
|
StreamTypeVideo StreamType = "video"
|
|
|
|
StreamTypeScreen StreamType = "screen"
|
|
|
|
)
|
|
|
|
|
|
|
|
func IsValidStreamType(s string) bool {
|
|
|
|
switch s {
|
|
|
|
case string(StreamTypeAudio):
|
|
|
|
fallthrough
|
|
|
|
case string(StreamTypeVideo):
|
|
|
|
fallthrough
|
|
|
|
case string(StreamTypeScreen):
|
|
|
|
return true
|
|
|
|
default:
|
|
|
|
return false
|
|
|
|
}
|
2020-05-12 09:46:20 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
type McuClient interface {
|
|
|
|
Id() string
|
2022-04-13 03:03:36 +02:00
|
|
|
Sid() string
|
2024-02-27 13:52:59 +01:00
|
|
|
StreamType() StreamType
|
2024-02-27 14:23:52 +01:00
|
|
|
MaxBitrate() int
|
2020-05-12 09:46:20 +02:00
|
|
|
|
|
|
|
Close(ctx context.Context)
|
|
|
|
|
|
|
|
SendMessage(ctx context.Context, message *MessageClientMessage, data *MessageClientMessageData, callback func(error, map[string]interface{}))
|
|
|
|
}
|
|
|
|
|
|
|
|
type McuPublisher interface {
|
|
|
|
McuClient
|
2021-11-08 12:06:59 +01:00
|
|
|
|
|
|
|
HasMedia(MediaType) bool
|
2022-04-05 19:27:37 +02:00
|
|
|
SetMedia(MediaType)
|
2024-04-18 12:47:29 +02:00
|
|
|
|
2024-04-18 16:48:10 +02:00
|
|
|
GetStreams(ctx context.Context) ([]PublisherStream, error)
|
2024-04-23 15:56:24 +02:00
|
|
|
PublishRemote(ctx context.Context, remoteId string, hostname string, port int, rtcpPort int) error
|
|
|
|
UnpublishRemote(ctx context.Context, remoteId string) error
|
2020-05-12 09:46:20 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
type McuSubscriber interface {
|
|
|
|
McuClient
|
|
|
|
|
|
|
|
Publisher() string
|
|
|
|
}
|
2024-04-18 12:47:29 +02:00
|
|
|
|
|
|
|
type McuRemotePublisherProperties interface {
|
|
|
|
Port() int
|
|
|
|
RtcpPort() int
|
|
|
|
}
|
|
|
|
|
|
|
|
type McuRemotePublisher interface {
|
|
|
|
McuClient
|
|
|
|
|
|
|
|
McuRemotePublisherProperties
|
|
|
|
}
|
|
|
|
|
|
|
|
type McuRemoteSubscriber interface {
|
|
|
|
McuSubscriber
|
|
|
|
}
|