38 | * This may not mean the user has a valid access token yet, 39 | * but the authentication strategy should be able to obtain one without further user interaction. 40 | * 41 | * @return True if the user is logically authorized 42 | * @since 0.1 43 | */ 44 | boolean isAuthorized(); 45 | 46 | /** 47 | * Deauthorizes the current user and clears any persistent state with regards to the current user. 48 | * If the {@link com.ciscospark.androidsdk.phone.Phone} is registered, 49 | * it should be deregistered before calling this method. 50 | * 51 | * @since 0.1 52 | */ 53 | void deauthorize(); 54 | 55 | /** 56 | * Returns an access token of this authenticator. 57 | *
58 | * This may involve long-running operations such as service calls, but may also return immediately.
59 | * The application should not make assumptions about how quickly this completes.
60 | *
61 | * @param handler a callback to be executed when completed, with the access token if successfuly retrieved, otherwise nil.
62 | * @since 0.1
63 | */
64 | void getToken(CompletionHandler
69 | * This may involve long-running operations such as service calls, but may also return immediately.
70 | * The application should not make assumptions about how quickly this completes.
71 | *
72 | * @param handler a callback to be executed when completed, with the access token if successfuly retrieved, otherwise nil.
73 | * @since 1.4
74 | */
75 | void refreshToken(CompletionHandler
36 | * This view is use by {@link MediaOption} and should be placed in Android layout xml file.
37 | *
38 | * e.g.
33 | * Room has been renamed to Space in Cisco Spark.
34 | *
35 | * @since 0.1
36 | */
37 | public class Room {
38 |
39 | /**
40 | * The enumeration of the types of a room.
41 | *
42 | * @since 0.1
43 | */
44 | public enum RoomType {
45 | /**
46 | * Group room among multiple people
47 | *
48 | * @since 0.1
49 | */
50 | @SerializedName("group")
51 | group,
52 |
53 | /**
54 | * 1-to-1 room between two people
55 | *
56 | * @since 0.1
57 | */
58 | @SerializedName("direct")
59 | direct
60 | }
61 |
62 | @SerializedName("id")
63 | private String _id;
64 |
65 | @SerializedName("title")
66 | private String _title;
67 |
68 | @SerializedName("type")
69 | private RoomType _type;
70 |
71 | @SerializedName("teamId")
72 | private String _teamId;
73 |
74 | @SerializedName("isLocked")
75 | private boolean _isLocked;
76 |
77 | @SerializedName("lastActivity")
78 | private Date _lastActivity;
79 |
80 | @SerializedName("created")
81 | private Date _created;
82 |
83 | @SerializedName("sipAddress")
84 | private String _sipAddress;
85 |
86 | @Override
87 | public String toString() {
88 | Gson gson = new Gson();
89 | return gson.toJson(this);
90 | }
91 |
92 | /**
93 | * @return The identifier of this room.
94 | * @since 0.1
95 | */
96 | public String getId() {
97 | return _id;
98 | }
99 |
100 | /**
101 | * @return The title of this room.
102 | * @since 0.1
103 | */
104 | public String getTitle() {
105 | return _title;
106 | }
107 |
108 | /**
109 | * @return The type of this room.
110 | * @since 0.1
111 | */
112 | public RoomType getType() {
113 | return _type;
114 | }
115 |
116 | /**
117 | * @return The team Id that this room associated with.
118 | * @since 0.1
119 | */
120 | public String getTeamId() {
121 | return _teamId;
122 | }
123 |
124 | /**
125 | * @return Indicate if this room is locked.
126 | * @since 0.1
127 | */
128 | public boolean isLocked() {
129 | return _isLocked;
130 | }
131 |
132 | /**
133 | * @return Last activity of this room.
134 | * @since 0.1
135 | */
136 | public Date getLastActivity() {
137 | return _lastActivity;
138 | }
139 |
140 | /**
141 | * @return The timestamp that this room being created.
142 | * @since 0.1
143 | */
144 | public Date getCreated() {
145 | return _created;
146 | }
147 |
148 | /**
149 | * @return The sipAddress that this room associated with.
150 | * @since 1.4
151 | */
152 | public String getSipAddress() {
153 | return _sipAddress;
154 | }
155 | }
--------------------------------------------------------------------------------
/sdk/src/main/java/com/ciscospark/androidsdk/room/RoomClient.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright 2016-2018 Cisco Systems Inc
3 | *
4 | * Permission is hereby granted, free of charge, to any person obtaining a copy
5 | * of this software and associated documentation files (the "Software"), to deal
6 | * in the Software without restriction, including without limitation the rights
7 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 | * copies of the Software, and to permit persons to whom the Software is
9 | * furnished to do so, subject to the following conditions:
10 | *
11 | * The above copyright notice and this permission notice shall be included in
12 | * all copies or substantial portions of the Software.
13 | *
14 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20 | * THE SOFTWARE.
21 | */
22 |
23 | package com.ciscospark.androidsdk.room;
24 |
25 |
26 | import java.util.List;
27 |
28 | import android.support.annotation.NonNull;
29 | import android.support.annotation.Nullable;
30 |
31 | import com.ciscospark.androidsdk.CompletionHandler;
32 |
33 | /**
34 | * A client wrapper of the Cisco Spark Rooms REST API
35 | *
36 | * @since 0.1
37 | */
38 | public interface RoomClient {
39 |
40 | /**
41 | * Sort results by room ID (id), most recent activity (lastactivity), or most recently created (created).
42 | *
43 | * @since 0.1
44 | */
45 | enum SortBy {
46 | ID, LASTACTIVITY, CREATED
47 | }
48 |
49 | /**
50 | * Lists all rooms where the authenticated user belongs.
51 | *
52 | * @param teamId If not nil, only list the rooms that are associated with the team by team id.
53 | * @param max The maximum number of rooms in the response.
54 | * @param type If not nil, only list the rooms of this type. Otherwise all rooms are listed.
55 | * @param sortBy Sort results by room ID (id), most recent activity (lastactivity), or most recently created (created).
56 | * @param handler A closure to be executed once the request has finished.
57 | * @since 0.1
58 | */
59 | void list(@Nullable String teamId, int max, @Nullable Room.RoomType type, @Nullable SortBy sortBy, @NonNull CompletionHandler
51 | * See the Team Memberships API to learn how to add more people to the team.
52 | *
53 | * @param name A user-friendly name for the team.
54 | * @param handler A closure to be executed once the request has finished.
55 | * @see TeamMembershipClient
56 | * @since 0.1
57 | */
58 | void create(@NonNull String name, @NonNull CompletionHandleractive to reactivate a disabled webhook.
137 | * @since 1.4
138 | */
139 | public String getStatus() {
140 | return _status;
141 | }
142 | }
143 |
--------------------------------------------------------------------------------
/sdk/src/main/java/com/ciscospark/androidsdk/webhook/WebhookClient.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright 2016-2018 Cisco Systems Inc
3 | *
4 | * Permission is hereby granted, free of charge, to any person obtaining a copy
5 | * of this software and associated documentation files (the "Software"), to deal
6 | * in the Software without restriction, including without limitation the rights
7 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 | * copies of the Software, and to permit persons to whom the Software is
9 | * furnished to do so, subject to the following conditions:
10 | *
11 | * The above copyright notice and this permission notice shall be included in
12 | * all copies or substantial portions of the Software.
13 | *
14 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20 | * THE SOFTWARE.
21 | */
22 |
23 | package com.ciscospark.androidsdk.webhook;
24 |
25 | import java.util.List;
26 |
27 | import android.support.annotation.NonNull;
28 | import android.support.annotation.Nullable;
29 |
30 | import com.ciscospark.androidsdk.CompletionHandler;
31 |
32 | /**
33 | * A client wrapper of the Cisco Spark Webhooks REST API
34 | *
35 | * @since 0.1
36 | */
37 | public interface WebhookClient {
38 |
39 | /**
40 | * Lists all webhooks of the authenticated user.
41 | *
42 | * @param max The maximum number of webhooks in the response.
43 | * @param handler A closure to be executed once the request has finished.
44 | * @since 0.1
45 | */
46 | void list(int max, @NonNull CompletionHandler