mirror of
https://github.com/strukturag/nextcloud-spreed-signaling.git
synced 2025-04-10 14:07:31 +00:00
3636e69dba
A new ID is introduced for publishers and subscribers to be able to identify different connections in the same session. While it was possible to do that from the Janus handles this ID is meant to be shared with the clients and set by the peer sending the offer, so it is set by the client for publishers and by the signaling server for subscribers (in which case the Janus handle is used). This will make possible to know without any ambiguity if an offer/answer belongs to an already existing connection or not. This can be used, for example, to know if an offer represents an update or a new connection, or to discard unneeded messages that might be sent in some corner cases by the clients. The ID name is "sid" for consistency with the property name used by the internal signaling server of Talk. Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
103 lines
2.4 KiB
Go
103 lines
2.4 KiB
Go
/**
|
|
* 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 (
|
|
"context"
|
|
"fmt"
|
|
|
|
"github.com/dlintw/goconf"
|
|
)
|
|
|
|
const (
|
|
McuTypeJanus = "janus"
|
|
McuTypeProxy = "proxy"
|
|
|
|
McuTypeDefault = McuTypeJanus
|
|
)
|
|
|
|
var (
|
|
ErrNotConnected = fmt.Errorf("not connected")
|
|
)
|
|
|
|
type MediaType int
|
|
|
|
const (
|
|
MediaTypeAudio MediaType = 1 << 0
|
|
MediaTypeVideo MediaType = 1 << 1
|
|
MediaTypeScreen MediaType = 1 << 2
|
|
)
|
|
|
|
type McuListener interface {
|
|
PublicId() string
|
|
|
|
OnUpdateOffer(client McuClient, offer map[string]interface{})
|
|
|
|
OnIceCandidate(client McuClient, candidate interface{})
|
|
OnIceCompleted(client McuClient)
|
|
|
|
SubscriberSidUpdated(subscriber McuSubscriber)
|
|
|
|
PublisherClosed(publisher McuPublisher)
|
|
SubscriberClosed(subscriber McuSubscriber)
|
|
}
|
|
|
|
type McuInitiator interface {
|
|
Country() string
|
|
}
|
|
|
|
type Mcu interface {
|
|
Start() error
|
|
Stop()
|
|
Reload(config *goconf.ConfigFile)
|
|
|
|
SetOnConnected(func())
|
|
SetOnDisconnected(func())
|
|
|
|
GetStats() interface{}
|
|
|
|
NewPublisher(ctx context.Context, listener McuListener, id string, sid string, streamType string, bitrate int, mediaTypes MediaType, initiator McuInitiator) (McuPublisher, error)
|
|
NewSubscriber(ctx context.Context, listener McuListener, publisher string, streamType string) (McuSubscriber, error)
|
|
}
|
|
|
|
type McuClient interface {
|
|
Id() string
|
|
Sid() string
|
|
StreamType() string
|
|
|
|
Close(ctx context.Context)
|
|
|
|
SendMessage(ctx context.Context, message *MessageClientMessage, data *MessageClientMessageData, callback func(error, map[string]interface{}))
|
|
}
|
|
|
|
type McuPublisher interface {
|
|
McuClient
|
|
|
|
HasMedia(MediaType) bool
|
|
SetMedia(MediaType)
|
|
}
|
|
|
|
type McuSubscriber interface {
|
|
McuClient
|
|
|
|
Publisher() string
|
|
}
|