1
0
mirror of https://github.com/arduino/Arduino.git synced 2024-12-13 23:48:46 +01:00
Arduino/hardware/arduino/avr/libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino

175 lines
6.5 KiB
Arduino
Raw Normal View History

2013-06-26 17:29:57 +02:00
/*
ReadATweet
Demonstrates retrieving the most recent Tweet from a user's home timeline
using the Temboo Arduino Yun SDK.
A Temboo account and application key are necessary to run all Temboo examples.
If you don't already have one, you can register for a free Temboo account at
http://www.temboo.com
In order to run this sketch, you'll need to register an application using
the Twitter dev console at https://dev.twitter.com. After creating the
app, you'll find OAuth credentials for that application under the "OAuth Tool" tab.
Substitute these values for the placeholders below.
This example assumes basic familiarity with Arduino sketches, and that your Yun
is connected to the Internet. For more tutorials on using the Temboo Library and
Temboo Arduino Yun SDK, visit http://www.temboo.com/arduino
This example code is in the public domain.
*/
#include <Bridge.h>
#include <Console.h>
#include <FileIO.h>
#include <HttpClient.h>
#include <Process.h>
#include "TembooAccount.h" // contains Temboo account information, as described below
int numRuns = 0; // execution count, so this sketch doesn't run forever
int maxRuns = 10; // the max number of times the Twitter HomeTimeline Choreo should run
void setup() {
Serial.begin(9600);
// for debugging, wait until a serial console is connected
delay(4000);
while(!Serial);
Bridge.begin();
}
void loop()
{
// while we haven't reached the max number of runs...
if (numRuns < maxRuns) {
// print status
Serial.println("Running HomeTimeline - Run #" + String(numRuns++));
// define the Process that will be used to call the "temboo" client
Process HomeTimelineChoreo;
// invoke the Temboo client
HomeTimelineChoreo.begin("temboo");
// set Temboo account credentials
HomeTimelineChoreo.addParameter("-a");
HomeTimelineChoreo.addParameter(TEMBOO_ACCOUNT);
HomeTimelineChoreo.addParameter("-u");
HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY_NAME);
HomeTimelineChoreo.addParameter("-p");
HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY);
// tell the Temboo client which Choreo to run (Twitter > Timelines > HomeTimeline)
HomeTimelineChoreo.addParameter("-c");
HomeTimelineChoreo.addParameter("/Library/Twitter/Timelines/HomeTimeline");
// set the required choreo inputs
// see https://www.temboo.com/library/Library/Twitter/Timelines/HomeTimeline/
// for complete details about the inputs for this Choreo
HomeTimelineChoreo.addParameter("-i");
HomeTimelineChoreo.addParameter("Count:1"); // the max number of Tweets to return from each request
// IMPORTANT! You'll need to substitute your own Access Token, Access Token Secret,
// Consumer Secret, and Consumer Key from the Twitter dev console into the method calls
// below. (Make sure not to delete the "AccessToken:" etc prefixes!)
HomeTimelineChoreo.addParameter("-i");
HomeTimelineChoreo.addParameter("AccessToken:your-twitter-access-token");
HomeTimelineChoreo.addParameter("-i");
HomeTimelineChoreo.addParameter("AccessTokenSecret:your-twitter-access-token-secret");
HomeTimelineChoreo.addParameter("-i");
HomeTimelineChoreo.addParameter("ConsumerSecret:your-twitter-consumer-secret");
HomeTimelineChoreo.addParameter("-i");
HomeTimelineChoreo.addParameter("ConsumerKey:your-twitter-consumer-key");
// next, we'll define two output filters that let us specify the
// elements of the response from Twitter that we want to receive.
// see the examples at http://www.temboo.com/arduino
// for more on using output filters
// we want the text of the tweet
HomeTimelineChoreo.addParameter("-o");
HomeTimelineChoreo.addParameter("tweet:/[1]/text:Response");
// and the name of the author
HomeTimelineChoreo.addParameter("-o");
HomeTimelineChoreo.addParameter("author:/[1]/user/screen_name:Response");
// tell the Process to run and wait for the results. The
// return code (rc) will tell us whether the Temboo client
// was able to send our request to the Temboo servers
unsigned int rc = HomeTimelineChoreo.run();
// a response code of 0 means success; print the API response
if(rc == 0) {
String author; // a String to hold the tweet author's name
String tweet; // a String to hold the text of the tweet
// choreo outputs are returned as key/value pairs, delimited with
// newlines and record/field terminator characters, for example:
// Name1\n\x1F
// Value1\n\x1E
// Name2\n\x1F
// Value2\n\x1E
// see the examples at http://www.temboo.com/arduino for more details
// we can read this format into separate variables, as follows:
while(HomeTimelineChoreo.available()) {
// read the name of the output item
String name = HomeTimelineChoreo.readStringUntil('\x1F');
name.trim();
// read the value of the output item
String data = HomeTimelineChoreo.readStringUntil('\x1E');
data.trim();
// assign the value to the appropriate String
if (name == "tweet") {
tweet = data;
} else if (name == "author") {
author = data;
}
}
Serial.println("@" + author + " - " + tweet);
} else {
// there was an error
// print the raw output from the choreo
while(HomeTimelineChoreo.available()) {
Serial.print((char)HomeTimelineChoreo.read());
}
}
HomeTimelineChoreo.close();
}
Serial.println("Sleeping...");
delay(90000); // sleep 90 seconds between HomeTimeline calls
}
/*
IMPORTANT NOTE: TembooAccount.h:
TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and
include the following variables and constants:
#define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name
#define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name
#define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key
The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
Visit https://www.temboo.com/account to access your Temboo account credentials.
Keeping your account information in a separate file means you can save it once,
then just distribute the main .ino file without worrying that you forgot to delete your credentials.
*/