/** * @file llfacebookconnect.h * @author Merov, Cho, Gil * @brief Connection to Facebook Service * * $LicenseInfo:firstyear=2013&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2013, 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 LL_LLFACEBOOKCONNECT_H #define LL_LLFACEBOOKCONNECT_H #include "llsingleton.h" #include "llimage.h" #include "llcoros.h" #include "lleventcoro.h" class LLEventPump; /** * @class LLFacebookConnect * * Manages authentication to, and interaction with, a web service allowing the * the viewer to get Facebook OpenGraph data. */ class LLFacebookConnect : public LLSingleton { LOG_CLASS(LLFacebookConnect); public: enum EConnectionState { FB_NOT_CONNECTED = 0, FB_CONNECTION_IN_PROGRESS = 1, FB_CONNECTED = 2, FB_CONNECTION_FAILED = 3, FB_POSTING = 4, FB_POSTED = 5, FB_POST_FAILED = 6, FB_DISCONNECTING = 7, FB_DISCONNECT_FAILED = 8 }; void connectToFacebook(const std::string& auth_code = "", const std::string& auth_state = ""); // Initiate the complete FB connection. Please use checkConnectionToFacebook() in normal use. void disconnectFromFacebook(); // Disconnect from the FBC service. void checkConnectionToFacebook(bool auto_connect = false); // Check if an access token is available on the FBC service. If not, call connectToFacebook(). void loadFacebookInfo(); void loadFacebookFriends(); void postCheckin(const std::string& location, const std::string& name, const std::string& description, const std::string& picture, const std::string& message); void sharePhoto(const std::string& image_url, const std::string& caption); void sharePhoto(LLPointer image, const std::string& caption); void updateStatus(const std::string& message); void storeInfo(const LLSD& info); const LLSD& getInfo() const; void clearInfo(); void storeContent(const LLSD& content); const LLSD& getContent() const; void clearContent(); void setDataDirty(); void setConnectionState(EConnectionState connection_state); void setConnected(bool connected); bool isConnected() { return mConnected; } bool isTransactionOngoing() { return ((mConnectionState == FB_CONNECTION_IN_PROGRESS) || (mConnectionState == FB_POSTING) || (mConnectionState == FB_DISCONNECTING)); } EConnectionState getConnectionState() { return mConnectionState; } void openFacebookWeb(std::string url); private: friend class LLSingleton; LLFacebookConnect(); ~LLFacebookConnect() {}; std::string getFacebookConnectURL(const std::string& route = "", bool include_read_from_master = false); EConnectionState mConnectionState; BOOL mConnected; LLSD mInfo; LLSD mContent; bool mRefreshInfo; bool mRefreshContent; bool mReadFromMaster; static boost::scoped_ptr sStateWatcher; static boost::scoped_ptr sInfoWatcher; static boost::scoped_ptr sContentWatcher; bool testShareStatus(LLSD &results); void facebookConnectCoro(LLCoros::self& self, std::string authCode, std::string authState); void facebookConnectedCheckCoro(LLCoros::self& self, bool autoConnect); void facebookDisconnectCoro(LLCoros::self& self); void facebookShareCoro(LLCoros::self& self, std::string route, LLSD share); void facebookShareImageCoro(LLCoros::self& self, std::string route, LLPointer image, std::string caption); void facebookConnectInfoCoro(LLCoros::self& self); void facebookConnectFriendsCoro(LLCoros::self& self); }; #endif // LL_LLFACEBOOKCONNECT_H