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
|
package webrtc
import (
"fmt"
"github.com/pion/ice/v2"
)
// ICECandidateType represents the type of the ICE candidate used.
type ICECandidateType int
const (
// ICECandidateTypeHost indicates that the candidate is of Host type as
// described in https://tools.ietf.org/html/rfc8445#section-5.1.1.1. A
// candidate obtained by binding to a specific port from an IP address on
// the host. This includes IP addresses on physical interfaces and logical
// ones, such as ones obtained through VPNs.
ICECandidateTypeHost ICECandidateType = iota + 1
// ICECandidateTypeSrflx indicates the the candidate is of Server
// Reflexive type as described
// https://tools.ietf.org/html/rfc8445#section-5.1.1.2. A candidate type
// whose IP address and port are a binding allocated by a NAT for an ICE
// agent after it sends a packet through the NAT to a server, such as a
// STUN server.
ICECandidateTypeSrflx
// ICECandidateTypePrflx indicates that the candidate is of Peer
// Reflexive type. A candidate type whose IP address and port are a binding
// allocated by a NAT for an ICE agent after it sends a packet through the
// NAT to its peer.
ICECandidateTypePrflx
// ICECandidateTypeRelay indicates the the candidate is of Relay type as
// described in https://tools.ietf.org/html/rfc8445#section-5.1.1.2. A
// candidate type obtained from a relay server, such as a TURN server.
ICECandidateTypeRelay
)
// This is done this way because of a linter.
const (
iceCandidateTypeHostStr = "host"
iceCandidateTypeSrflxStr = "srflx"
iceCandidateTypePrflxStr = "prflx"
iceCandidateTypeRelayStr = "relay"
)
// NewICECandidateType takes a string and converts it into ICECandidateType
func NewICECandidateType(raw string) (ICECandidateType, error) {
switch raw {
case iceCandidateTypeHostStr:
return ICECandidateTypeHost, nil
case iceCandidateTypeSrflxStr:
return ICECandidateTypeSrflx, nil
case iceCandidateTypePrflxStr:
return ICECandidateTypePrflx, nil
case iceCandidateTypeRelayStr:
return ICECandidateTypeRelay, nil
default:
return ICECandidateType(Unknown), fmt.Errorf("%w: %s", errICECandidateTypeUnknown, raw)
}
}
func (t ICECandidateType) String() string {
switch t {
case ICECandidateTypeHost:
return iceCandidateTypeHostStr
case ICECandidateTypeSrflx:
return iceCandidateTypeSrflxStr
case ICECandidateTypePrflx:
return iceCandidateTypePrflxStr
case ICECandidateTypeRelay:
return iceCandidateTypeRelayStr
default:
return ErrUnknownType.Error()
}
}
func getCandidateType(candidateType ice.CandidateType) (ICECandidateType, error) {
switch candidateType {
case ice.CandidateTypeHost:
return ICECandidateTypeHost, nil
case ice.CandidateTypeServerReflexive:
return ICECandidateTypeSrflx, nil
case ice.CandidateTypePeerReflexive:
return ICECandidateTypePrflx, nil
case ice.CandidateTypeRelay:
return ICECandidateTypeRelay, nil
default:
// NOTE: this should never happen[tm]
err := fmt.Errorf("%w: %s", errICEInvalidConvertCandidateType, candidateType.String())
return ICECandidateType(Unknown), err
}
}
|
