summaryrefslogtreecommitdiff
path: root/indra/llwebrtc/llwebrtc.h
blob: ca558add014acd9da350fa427876dc979203d0c0 (plain)
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/**
 * @file llaccordionctrl.cpp
 * @brief Accordion panel  implementation
 *
 * $LicenseInfo:firstyear=2023&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2023, Linden Research, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */

#ifndef LLWEBRTC_H
#define LLWEBRTC_H

#include <string>
#include <vector>

#ifdef LL_MAKEDLL
#ifdef WEBRTC_WIN
#define LLSYMEXPORT __declspec(dllexport)
#elif WEBRTC_LINUX
#define LLSYMEXPORT __attribute__((visibility("default")))
#else
#define LLSYMEXPORT /**/
#endif
#else
#define LLSYMEXPORT /**/
#endif // LL_MAKEDLL

namespace llwebrtc
{
LLSYMEXPORT void init();

struct LLWebRTCIceCandidate
{
    std::string candidate;
    std::string sdp_mid;
    int         mline_index;
};

class LLWebRTCVoiceDevice
{
  public:
    std::string display_name;  // friendly value for the user
    std::string id;     // internal value for selection

    LLWebRTCVoiceDevice(const std::string &display_name, const std::string &id) :
        display_name(display_name),
        id(id) {};
};

typedef std::vector<LLWebRTCVoiceDevice> LLWebRTCVoiceDeviceList;

class LLWebRTCDevicesObserver
{
  public:
    virtual void OnRenderDevicesChanged(const LLWebRTCVoiceDeviceList &render_devices) = 0;
    virtual void OnCaptureDevicesChanged(const LLWebRTCVoiceDeviceList &capture_devices) = 0;
};

class LLWebRTCDeviceInterface
{
  public:

    virtual void refreshDevices() = 0;

    virtual void setCaptureDevice(const std::string& id) = 0;
    virtual void setRenderDevice(const std::string& id) = 0;

    virtual void setDevicesObserver(LLWebRTCDevicesObserver *observer) = 0;
    virtual void unsetDevicesObserver(LLWebRTCDevicesObserver *observer) = 0;

    virtual void setTuningMode(bool enable) = 0;
    virtual double getTuningMicrophoneEnergy() = 0;
};

class LLWebRTCAudioInterface
{
  public:
    virtual void setMute(bool mute) = 0;
    virtual void setSpeakerVolume(float volume) = 0;  // volume between 0.0 and 1.0
};

class LLWebRTCSignalingObserver
{
  public: 
    enum IceGatheringState{
        ICE_GATHERING_NEW,
        ICE_GATHERING_GATHERING,
        ICE_GATHERING_COMPLETE
    };
    virtual void OnIceGatheringState(IceGatheringState state) = 0;
    virtual void OnIceCandidate(const LLWebRTCIceCandidate& candidate) = 0;
    virtual void OnOfferAvailable(const std::string& sdp) = 0;
    virtual void OnRenegotiationNeeded() = 0;
    virtual void OnAudioEstablished(LLWebRTCAudioInterface *audio_interface) = 0;
};

class LLWebRTCSignalInterface
{
  public:
    virtual void setSignalingObserver(LLWebRTCSignalingObserver* observer) = 0;
    virtual void unsetSignalingObserver(LLWebRTCSignalingObserver* observer) = 0;

    virtual bool initializeConnection() = 0;
    virtual void shutdownConnection() = 0;
    virtual void AnswerAvailable(const std::string &sdp) = 0;
};

LLSYMEXPORT LLWebRTCDeviceInterface* getDeviceInterface();
LLSYMEXPORT LLWebRTCSignalInterface* getSignalingInterface();
}

#endif // LLWEBRTC_H