[[Image(dune_trans.jpg, align=right, 300px)]]
= Dune HD Media Player Plugin =
The Dune HD Media player is a device that can play audio/video shared from a NAS on your home network. It can also act as a NAS by itself by installing disk(s) into the device itself. 

This plugin can be used to trigger scenes on your Vera device automatically when player enters different states. For example lower blinds when movie starts or turn on lights when movie is stopped.

Link to company page
http://dune-hd.com
\\
Relevant forum thread
http://forum.micasaverde.com/index.php/topic,14107.0.html



=== Author ===

'''Henrik Ekblad''' - henrik.ekblad at gmail.com (hek on forum)


{{{
<a href="https://www.beerdonation.com/p/ctLsvf9Kp1g2kdq/">
    <img src="https://www.beerdonation.com/p/ctLsvf9Kp1g2kdq/badge" alt="Beer Me!" title="Beer Me!" />
</a>
}}}

[[Image(plugin.png, align=right)]]
=== Installing the plugin ===

==== From apps.mios.com ====

Not on market yet

==== From downloaded source ====

1. Download '''D_Dune.json, D_Dune.xml, I_Dune.xml, S_Dune.xml, xmlSimple.lua''' found under "Browse Source">trunk above.
i. Go to: Apps -> Develop Apps -> Luup files in Vera UI
i. Add the five files using "Browse"-button. Click "Restart Luup after upload" checkbox and press Go.
i. Go to: Apps -> Develop Apps -> Create Device
i. Set "Upnp Device Filename" to "D_Dune.xml"
i. Set "Upnp Implementation Filename" to "I_Dune.xml"
i. Click "Create Device"
i. Reload
i. Go to device settings and update the default ip of your Dune box. 
i. Reload
i. OPTIONAL: If you want an icon download '''dune_icon.png''' and SCP it to your vera box under ''/www/cmh/skins/default/icons/dune_icon.png''


=== Configuration ===
|| '''Parameter''' || '''Description''' ||
|| ip || Ip number for your Dune box ||
|| !PollIntervalOnline || Poll interval for fetching player state (in seconds) when dune player is online ||
|| !PollIntervalOffline || Poll interval for trying to fetch player state (in seconds) when offline. This interval will be used when http connection does a timeout when trying to fetch state. ||

=== Notifications ===

The following notification triggers can be used in your scenes.

|| '''!PlayerState''' || '''Description''' || 
||off|| Dune player is offline or turned off.  ||
||standby|| Standby mode. ||
||loading|| Transitioning between two player states. ||
||navigator|| Navigator mode. ||
||torrent_downloads|| Showing the torrent client. ||
||photo_viewer|| Showing an image or image slideshow. ||
||black_screen|| Showing a black screen. ||
||dvd_playback|| Playing a DVD structure. ||
||bluray_playback|| Playing a Blu-ray structure. ||
||file_playback|| Playing an arbitrary file. || 
||safe_mode|| Changing display mode. ||	
\\
|| '''!PlaybackState''' || '''Description''' || 
||playing||Ongoing playback||
||initializing||Playback initializing ||
||paused||Paused ||
||seeking||Seeking (fast forward, rewinding) ||
||stopped||Stopped ||
||deinitializing||? ||
||buffering||Buffering stream ||
||finished||Will immediately go to 'stopped' from this state ||

=== Actions ===

Only action "Play" and "Pause" is implemented at the moment.

=== Example ===
To fetch the playback state in luup code use the following:

{{{
local playbackState = luup.variable_get( 'urn:hek:serviceId:Dune1', "PlaybackState", <deviceId>)
}}}


=== API Description ===
A big thanks to Steven Liekens who has collected all information available on one place regarding IP-command interface for Dune Players. It helped alot when developing this plugin.
https://code.google.com/p/dune-api-codepack/wiki/ApiReference