smsplugin.h 6.12 KB
Newer Older
1
2
/**
 * Copyright 2013 Albert Vaca <albertvaka@gmail.com>
3
 * Copyright 2018 Simon Redman <simon@ergotech.com>
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License or (at your option) version 3 or any later version
 * accepted by the membership of KDE e.V. (or its successor approved
 * by the membership of KDE e.V.), which shall act as a proxy
 * defined in Section 14 of version 3 of the license.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
19
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 */

#ifndef SMSPLUGIN_H
#define SMSPLUGIN_H

#include <QObject>

#include <core/kdeconnectplugin.h>

#include "conversationsdbusinterface.h"
#include "interfaces/conversationmessage.h"

/**
 * Packet used to indicate a batch of messages has been pushed from the remote device
 *
 * The body should contain the key "messages" mapping to an array of messages
 *
 * For example:
Simon Redman's avatar
Simon Redman committed
38
39
40
41
42
 * {
 *   "version": 2                     // This is the second version of this packet type and
 *                                    // version 1 packets (which did not carry this flag)
 *                                    // are incompatible with the new format
 *   "messages" : [
43
44
45
46
 *   { "event"     : 1,               // 32-bit field containing a bitwise-or of event flags
 *                                    // See constants declared in SMSHelper.Message for defined
 *                                    // values and explanations
 *     "body"      : "Hello",         // Text message body
Simon Redman's avatar
Simon Redman committed
47
48
 *     "addresses": <List<Address>>   // List of Address objects, one for each participant of the conversation
 *                                    // The user's Address is excluded so:
Yuri Chornoivan's avatar
Yuri Chornoivan committed
49
 *                                    // If this is a single-target message, there will only be one
Simon Redman's avatar
Simon Redman committed
50
51
52
53
54
 *                                    // Address (the other party)
 *                                    // If this is an incoming multi-target message, the first Address is the
 *                                    // sender and all other addresses are other parties to the conversation
 *                                    // If this is an outgoing multi-target message, the sender is implicit
 *                                    // (the user's phone number) and all Addresses are recipients
55
56
57
 *     "date"      : "1518846484880", // Timestamp of the message
 *     "type"      : "2",   // Compare with Android's
 *                          // Telephony.TextBasedSmsColumns.MESSAGE_TYPE_*
Simon Redman's avatar
Simon Redman committed
58
 *     "thread_id" : 132    // Thread to which the message belongs
59
60
61
62
63
 *     "read"      : true   // Boolean representing whether a message is read or unread
 *   },
 *   { ... },
 *   ...
 * ]
Simon Redman's avatar
Simon Redman committed
64
65
66
67
68
69
70
71
72
73
74
75
 *
 * The following optional fields of a message object may be defined
 * "sub_id": <int> // Android's subscriber ID, which is basically used to determine which SIM card the message
 *                 // belongs to. This is mostly useful when attempting to reply to an SMS with the correct
 *                 // SIM card using PACKET_TYPE_SMS_REQUEST.
 *                 // If this value is not defined or if it does not match a valid subscriber_id known by
 *                 // Android, we will use whatever subscriber ID Android gives us as the default
 *
 * An Address object looks like:
 * {
 *     "address": <String> // Address (phone number, email address, etc.) of this object
 * }
76
 */
77
#define PACKET_TYPE_SMS_MESSAGES QStringLiteral("kdeconnect.sms.messages")
78

79
80
81
82
83
84
85
86
/**
 * Packet sent to request a message be sent
 *
 * This will almost certainly need to be replaced or augmented to support MMS,
 * but be sure the Android side remains compatible with old desktop apps!
 *
 * The body should look like so:
 * { "sendSms": true,
87
 *   "addresses": <List of Addresses>
88
89
 *   "messageBody": "Hi mom!",
 *   "sub_id": "3859358340534"
90
91
 * }
 */
92
93
94
#define PACKET_TYPE_SMS_REQUEST QStringLiteral("kdeconnect.sms.request")

/**
95
 * Packet sent to request the most-recent message in each conversations on the device
96
97
98
 *
 * The request packet shall contain no body
 */
99
#define PACKET_TYPE_SMS_REQUEST_CONVERSATIONS QStringLiteral("kdeconnect.sms.request_conversations")
100
101
102
103

/**
 * Packet sent to request all the messages in a particular conversation
 *
104
 * The body should contain the key "threadID" mapping to the threadID being requested
105
106
107
 * For example:
 * { "threadID": 203 }
 */
108
#define PACKET_TYPE_SMS_REQUEST_CONVERSATION QStringLiteral("kdeconnect.sms.request_conversation")
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

Q_DECLARE_LOGGING_CATEGORY(KDECONNECT_PLUGIN_SMS)

class Q_DECL_EXPORT SmsPlugin
    : public KdeConnectPlugin
{
    Q_OBJECT
    Q_CLASSINFO("D-Bus Interface", "org.kde.kdeconnect.device.sms")

public:
    explicit SmsPlugin(QObject* parent, const QVariantList& args);
    ~SmsPlugin() override;

    bool receivePacket(const NetworkPacket& np) override;
    void connected() override {}

    QString dbusPath() const override;

public Q_SLOTS:
128
    Q_SCRIPTABLE void sendSms(const QVariantList& addresses, const QString& messageBody, const qint64 subID = -1);
129
130
131
132
133
134
135
136

    /**
     * Send a request to the remote for all of its conversations
     */
    Q_SCRIPTABLE void requestAllConversations();

    /**
     * Send a request to the remote for a particular conversation
137
138
     *
     * TODO: Make interface capable of requesting limited window of messages
139
     */
140
    Q_SCRIPTABLE void requestConversation(const qint64& conversationID) const;
141

142
143
    Q_SCRIPTABLE void launchApp();

144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
private:

    /**
     * Send to the telepathy plugin if it is available
     */
    void forwardToTelepathy(const ConversationMessage& message);

    /**
     * Handle a packet which contains many messages, such as PACKET_TYPE_TELEPHONY_MESSAGE
     */
    bool handleBatchMessages(const NetworkPacket& np);

    QDBusInterface m_telepathyInterface;
    ConversationsDbusInterface* m_conversationInterface;
};

#endif