mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 15:42:10 +01:00
ce3f673380
* Apply markdown fixes for bindings with letter _t_ * Apply markdown fixes for bindings with letter _u_ * Apply markdown fixes for bindings with letter _v_ * Apply markdown fixes for bindings with letter _w_ * Apply markdown fixes for bindings with letter _x_ * Apply markdown fixes for bindings with letter _y_ * Apply markdown fixes for bindings with letter _z_ Signed-off-by: Jerome Luckenbach <github@luckenba.ch>
64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
# Twitter Binding
|
|
|
|
The Twitter binding allows your home to Tweet 280 characters at a time. It also supports direct messages and tweeting with media.
|
|
|
|
## Supported Things
|
|
|
|
```text
|
|
account - Twitter Account.
|
|
```
|
|
|
|
## Thing Configuration
|
|
|
|
The Twitter Account Thing requires you to create a Twitter App in the Twitter Developer Page.
|
|
|
|
| Property | Default | Required | Description |
|
|
|-------------------|---------|:--------:|-----------------------------------|
|
|
| consumerKey | | Yes | Consumer API Key |
|
|
| consumerSecret | | Yes | Consumer API Secret |
|
|
| accessToken | | Yes | Access Token |
|
|
| accessTokenSecret | | Yes | Access Token Secret |
|
|
| refresh | 30 | No | Tweet refresh interval in minutes |
|
|
|
|
## Channels
|
|
|
|
| channel | type | description |
|
|
|------------|--------|------------------------------------------------|
|
|
| lasttweet | String | This channel provides the Latest Tweet message |
|
|
|
|
## Full Example
|
|
|
|
twitter.things:
|
|
|
|
```java
|
|
Thing twitter:account:sampleaccount [ consumerKey="11111", consumerSecret="22222", accessToken="33333", accessTokenSecret="444444" ]
|
|
|
|
```
|
|
|
|
twitter.items:
|
|
|
|
```java
|
|
String sample_tweet "Latest Tweet: [%s]" { channel="twitter:account:sampleaccount:lasttweet" }
|
|
|
|
```
|
|
|
|
## Rule Action
|
|
|
|
This binding includes rule actions for sending tweets and direct messages.
|
|
|
|
- `boolean success = sendTweet(String text)`
|
|
- `boolean success = sendTweetWithAttachment(String text, String URL)`
|
|
- `boolean success = sendDirectMessage(String recipientID, String text)`
|
|
|
|
Examples:
|
|
|
|
```java
|
|
val tweetActions = getActions("twitter","twitter:account:sampleaccount")
|
|
val success = tweetActions.sendTweet("This is A Tweet")
|
|
val success2 = tweetActions.sendTweetWithAttachment("This is A Tweet with a Pic", file:///tmp/201601011031.jpg)
|
|
val success3 = tweetActions.sendTweetWithAttachment("Windows Picture", "D:\\Test.png" )
|
|
val success4 = tweetActions.sendTweetWithAttachment("HTTP Picture", "http://www.mywebsite.com/Test.png" )
|
|
val success5 = tweetActions.sendDirectMessage("1234567", "Wake Up" )
|
|
|
|
```
|