QXmppCall.h

// SPDX-FileCopyrightText: 2019 Jeremy Lainé <jeremy.laine@m4x.org>
// SPDX-FileCopyrightText: 2019 Niels Ole Salscheider <ole@salscheider.org>
// SPDX-FileCopyrightText: 2025 Linus Jahn <lnj@kaidan.im>
//
// SPDX-License-Identifier: LGPL-2.1-or-later

#ifndef QXMPPCALL_H
#define QXMPPCALL_H

#include "QXmppCallStream.h"
#include "QXmppClientExtension.h"
#include "QXmppLogger.h"

#include <QMetaType>
#include <QObject>

class QHostAddress;
class QXmppCallPrivate;
class QXmppCallManager;
class QXmppCallManagerPrivate;
class QXmppError;

class QXMPP_EXPORT QXmppCall : public QXmppLoggable
{
    Q_OBJECT
    Q_PROPERTY(Direction direction READ direction CONSTANT)
    Q_PROPERTY(QString jid READ jid CONSTANT)
    Q_PROPERTY(State state READ state NOTIFY stateChanged)

public:
    enum Direction {
        IncomingDirection,  
        OutgoingDirection   
    };
    Q_ENUM(Direction)

    
    enum State {
        ConnectingState = 0,     
        ActiveState = 1,         
        DisconnectingState = 2,  
        FinishedState = 3        
    };
    Q_ENUM(State)

    ~QXmppCall();

    QXmppCall::Direction direction() const;
    QString jid() const;
    QString sid() const;
    QXmppCall::State state() const;
    std::optional<QXmppError> error() const;

    GstElement *pipeline() const;
    QXmppCallStream *audioStream() const;
    QXmppCallStream *videoStream() const;

    bool isEncrypted() const;
    bool videoSupported() const;

    void accept();
    void decline();
    void hangUp();
    void addVideo();

    Q_SIGNAL void connected();

    Q_SIGNAL void finished();

    Q_SIGNAL void ringing();

    Q_SIGNAL void stateChanged(QXmppCall::State state);

    Q_SIGNAL void streamCreated(QXmppCallStream *stream);

private:
    void onLocalCandidatesChanged(QXmppCallStream *stream);
    void terminated();

    QXmppCall(const QString &jid, const QString &sid, Direction direction, QXmppCallManager *manager);
    QXmppCall(const QString &jid, const QString &sid, Direction direction, State state, QXmppError &&error, QXmppCallManager *manager);

    const std::unique_ptr<QXmppCallPrivate> d;
    friend class QXmppCallManager;
    friend class QXmppCallManagerPrivate;
    friend class QXmppCallPrivate;
};

Q_DECLARE_METATYPE(QXmppCall::State)

#endif