forked from pion/webrtc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
api.go
96 lines (77 loc) · 2.45 KB
/
api.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
package webrtc
import (
"time"
)
// API bundles the global funcions of the WebRTC and ORTC API.
// Some of these functions are also exported globally using the
// defaultAPI object. Note that the global version of the API
// may be phased out in the future.
type API struct {
settingEngine *SettingEngine
mediaEngine *MediaEngine
}
// NewAPI Creates a new API object for keeping semi-global settings to WebRTC objects
func NewAPI(options ...func(*API)) *API {
a := &API{}
for _, o := range options {
o(a)
}
if a.settingEngine == nil {
a.settingEngine = &SettingEngine{}
}
if a.mediaEngine == nil {
a.mediaEngine = &MediaEngine{}
}
return a
}
// WithMediaEngine allows providing a MediaEngine to the API.
// Settings should not be changed after passing the engine to an API.
func WithMediaEngine(m MediaEngine) func(a *API) {
return func(a *API) {
a.mediaEngine = &m
}
}
// WithSettingEngine allows providing a SettingEngine to the API.
// Settings should not be changed after passing the engine to an API.
func WithSettingEngine(s SettingEngine) func(a *API) {
return func(a *API) {
a.settingEngine = &s
}
}
// defaultAPI is used to support the legacy global API.
// This global API should not be extended and may be phased out
// in the future.
var defaultAPI = NewAPI()
// Setting engine API
// SetEphemeralUDPPortRange on the default API.
// See SettingEngine for details.
func SetEphemeralUDPPortRange(portMin, portMax uint16) error {
return defaultAPI.settingEngine.SetEphemeralUDPPortRange(portMin, portMax)
}
// DetachDataChannels on the default API.
// See SettingEngine for details.
func DetachDataChannels() {
defaultAPI.settingEngine.DetachDataChannels()
}
// SetConnectionTimeout on the default API.
// See SettingEngine for details.
func SetConnectionTimeout(connectionTimeout, keepAlive time.Duration) {
defaultAPI.settingEngine.SetConnectionTimeout(connectionTimeout, keepAlive)
}
// Media Engine API
// RegisterCodec on the default API.
// See MediaEngine for details.
func RegisterCodec(codec *RTCRtpCodec) {
defaultAPI.mediaEngine.RegisterCodec(codec)
}
// RegisterDefaultCodecs on the default API.
// See MediaEngine for details.
func RegisterDefaultCodecs() {
defaultAPI.mediaEngine.RegisterDefaultCodecs()
}
// PeerConnection API
// New using the default API.
// See API.NewRTCPeerConnection for details.
func New(configuration RTCConfiguration) (*RTCPeerConnection, error) {
return defaultAPI.NewRTCPeerConnection(configuration)
}