eosc-rs 2.0.1

A wrapper for EOS v2 OSC commands
Documentation 
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

use std::net::{IpAddr, UdpSocket};

use rosc::{OscError, OscMessage, OscPacket, OscType};
use snafu::{ResultExt, Snafu};

pub struct OscSender {
    target: (IpAddr, u16),
    socket: UdpSocket,
}

#[derive(Debug, Snafu)]
pub enum OscSenderError {
    #[snafu(display("failed to bind UDP socket to {to:#?}"))]
    UDPBind {
        source: std::io::Error,
        to: (IpAddr, u16),
    },

    #[snafu(display("failed to encode OSC packet with destination {address}"))]
    OSCPacketEncoding { source: OscError, address: String },

    #[snafu(display("failed to send UDP packet with data: {data:#?} to {to:#?}"))]
    UDPSend {
        source: std::io::Error,
        data: Vec<u8>,
        to: (IpAddr, u16),
    },
}

impl OscSender {
    /// Creates a new OSCSender
    /// Binds to "bind", should normally be 0.0.0.0 at whatever port you would like
    /// Sends messages to "target", the IP address and port should match that of what you are sending to
    pub fn new(bind: (IpAddr, u16), target: (IpAddr, u16)) -> Result<Self, OscSenderError> {
        let socket = UdpSocket::bind(bind).context(UDPBindSnafu { to: bind })?;

        Ok(Self { target, socket })
    }

    pub fn send_osc(&self, address: String, args: Vec<OscType>) -> Result<(), OscSenderError> {
        let packet = OscPacket::Message(OscMessage {
            addr: address.clone(),
            args,
        });

        let data = rosc::encoder::encode(&packet).context(OSCPacketEncodingSnafu {
            address: address.to_string(),
        })?;

        self.socket
            .send_to(data.as_slice(), self.target)
            .context(UDPSendSnafu {
                data,
                to: self.target,
            })?;

        Ok(())
    }
}