2022-03-10 09:44:48 +00:00
|
|
|
package ice
|
|
|
|
|
|
|
|
import (
|
|
|
|
"context"
|
|
|
|
"net"
|
|
|
|
"sync/atomic"
|
|
|
|
"time"
|
|
|
|
|
|
|
|
"github.com/pion/stun"
|
|
|
|
)
|
|
|
|
|
|
|
|
// Dial connects to the remote agent, acting as the controlling ice agent.
|
|
|
|
// Dial blocks until at least one ice candidate pair has successfully connected.
|
|
|
|
func (a *Agent) Dial(ctx context.Context, remoteUfrag, remotePwd string) (*Conn, error) {
|
|
|
|
return a.connect(ctx, true, remoteUfrag, remotePwd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Accept connects to the remote agent, acting as the controlled ice agent.
|
|
|
|
// Accept blocks until at least one ice candidate pair has successfully connected.
|
|
|
|
func (a *Agent) Accept(ctx context.Context, remoteUfrag, remotePwd string) (*Conn, error) {
|
|
|
|
return a.connect(ctx, false, remoteUfrag, remotePwd)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Conn represents the ICE connection.
|
|
|
|
// At the moment the lifetime of the Conn is equal to the Agent.
|
|
|
|
type Conn struct {
|
|
|
|
bytesReceived uint64
|
|
|
|
bytesSent uint64
|
|
|
|
agent *Agent
|
|
|
|
}
|
|
|
|
|
|
|
|
// BytesSent returns the number of bytes sent
|
|
|
|
func (c *Conn) BytesSent() uint64 {
|
|
|
|
return atomic.LoadUint64(&c.bytesSent)
|
|
|
|
}
|
|
|
|
|
|
|
|
// BytesReceived returns the number of bytes received
|
|
|
|
func (c *Conn) BytesReceived() uint64 {
|
|
|
|
return atomic.LoadUint64(&c.bytesReceived)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (a *Agent) connect(ctx context.Context, isControlling bool, remoteUfrag, remotePwd string) (*Conn, error) {
|
|
|
|
err := a.ok()
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
2024-01-18 18:54:54 +00:00
|
|
|
err = a.startConnectivityChecks(isControlling, remoteUfrag, remotePwd)
|
2022-03-10 09:44:48 +00:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
2024-01-18 18:54:54 +00:00
|
|
|
// block until pair selected
|
2022-03-10 09:44:48 +00:00
|
|
|
select {
|
|
|
|
case <-a.done:
|
|
|
|
return nil, a.getErr()
|
|
|
|
case <-ctx.Done():
|
|
|
|
return nil, ErrCanceledByCaller
|
|
|
|
case <-a.onConnected:
|
|
|
|
}
|
|
|
|
|
|
|
|
return &Conn{
|
|
|
|
agent: a,
|
|
|
|
}, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// Read implements the Conn Read method.
|
|
|
|
func (c *Conn) Read(p []byte) (int, error) {
|
|
|
|
err := c.agent.ok()
|
|
|
|
if err != nil {
|
|
|
|
return 0, err
|
|
|
|
}
|
|
|
|
|
2024-01-18 18:54:54 +00:00
|
|
|
n, err := c.agent.buffer.Read(p)
|
2022-03-10 09:44:48 +00:00
|
|
|
atomic.AddUint64(&c.bytesReceived, uint64(n))
|
|
|
|
return n, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Write implements the Conn Write method.
|
|
|
|
func (c *Conn) Write(p []byte) (int, error) {
|
|
|
|
err := c.agent.ok()
|
|
|
|
if err != nil {
|
|
|
|
return 0, err
|
|
|
|
}
|
|
|
|
|
|
|
|
if stun.IsMessage(p) {
|
|
|
|
return 0, errICEWriteSTUNMessage
|
|
|
|
}
|
|
|
|
|
|
|
|
pair := c.agent.getSelectedPair()
|
|
|
|
if pair == nil {
|
|
|
|
if err = c.agent.run(c.agent.context(), func(ctx context.Context, a *Agent) {
|
|
|
|
pair = a.getBestValidCandidatePair()
|
|
|
|
}); err != nil {
|
|
|
|
return 0, err
|
|
|
|
}
|
|
|
|
|
|
|
|
if pair == nil {
|
|
|
|
return 0, err
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
atomic.AddUint64(&c.bytesSent, uint64(len(p)))
|
|
|
|
return pair.Write(p)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Close implements the Conn Close method. It is used to close
|
|
|
|
// the connection. Any calls to Read and Write will be unblocked and return an error.
|
|
|
|
func (c *Conn) Close() error {
|
|
|
|
return c.agent.Close()
|
|
|
|
}
|
|
|
|
|
|
|
|
// LocalAddr returns the local address of the current selected pair or nil if there is none.
|
|
|
|
func (c *Conn) LocalAddr() net.Addr {
|
|
|
|
pair := c.agent.getSelectedPair()
|
|
|
|
if pair == nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
return pair.Local.addr()
|
|
|
|
}
|
|
|
|
|
|
|
|
// RemoteAddr returns the remote address of the current selected pair or nil if there is none.
|
|
|
|
func (c *Conn) RemoteAddr() net.Addr {
|
|
|
|
pair := c.agent.getSelectedPair()
|
|
|
|
if pair == nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
return pair.Remote.addr()
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetDeadline is a stub
|
2024-01-18 18:54:54 +00:00
|
|
|
func (c *Conn) SetDeadline(t time.Time) error {
|
2022-03-10 09:44:48 +00:00
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetReadDeadline is a stub
|
2024-01-18 18:54:54 +00:00
|
|
|
func (c *Conn) SetReadDeadline(t time.Time) error {
|
2022-03-10 09:44:48 +00:00
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetWriteDeadline is a stub
|
2024-01-18 18:54:54 +00:00
|
|
|
func (c *Conn) SetWriteDeadline(t time.Time) error {
|
2022-03-10 09:44:48 +00:00
|
|
|
return nil
|
|
|
|
}
|