1
0
Fork 0
mirror of https://github.com/Yetangitu/ampache synced 2025-10-03 17:59:21 +02:00
ampache/lib/class/daap_api.class.php
2015-04-01 19:51:19 +02:00

741 lines
28 KiB
PHP

<?php
/* vim:set softtabstop=4 shiftwidth=4 expandtab: */
/**
*
* LICENSE: GNU General Public License, version 2 (GPLv2)
* Copyright 2001 - 2015 Ampache.org
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; version 2
* of the License.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*
*/
/**
* DAAP Class
*
* This class wrap Ampache to DAAP API functions. See https://github.com/andytinycat/daapdocs/blob/master/daapdocs.txt
* These are all static calls.
*
*/
class Daap_Api
{
const AMPACHEID_SMARTPL = 400000000;
public static $tags = array();
/**
* constructor
* This really isn't anything to do here, so it's private
*/
private function __construct()
{
}
public static function follow_stream($url)
{
set_time_limit(0);
ob_end_clean();
if (function_exists('curl_version')) {
$headers = apache_request_headers();
$reqheaders = array();
$reqheaders[] = "User-Agent: " . $headers['User-Agent'];
if (isset($headers['Range'])) {
$reqheaders[] = "Range: " . $headers['Range'];
}
// Curl support, we stream transparently to avoid redirect. Redirect can fail on few clients
$ch = curl_init($url);
curl_setopt_array($ch, array(
CURLOPT_HTTPHEADER => $reqheaders,
CURLOPT_HEADER => false,
CURLOPT_RETURNTRANSFER => false,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_WRITEFUNCTION => array('Daap_Api', 'output_body'),
CURLOPT_HEADERFUNCTION => array('Daap_Api', 'output_header'),
// Ignore invalid certificate
// Default trusted chain is crap anyway and currently no custom CA option
CURLOPT_SSL_VERIFYPEER => false,
CURLOPT_SSL_VERIFYHOST => false,
CURLOPT_TIMEOUT => 0
));
curl_exec($ch);
curl_close($ch);
} else {
// Stream media using http redirect if no curl support
header("Location: " . $url);
}
}
public static function output_body($ch, $data)
{
echo $data;
ob_flush();
return strlen($data);
}
public static function output_header($ch, $header)
{
$rheader = trim($header);
$rhpart = explode(':', $rheader);
if (!empty($rheader) && count($rhpart) > 1) {
if ($rhpart[0] != "Transfer-Encoding") {
header($rheader);
}
}
return strlen($header);
}
/**
* server_info
*
*/
public static function server_info($input)
{
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('daap.protocolversion', '0.3.0.0');
$o .= self::tlv('dmap.authenticationmethod', 2);
$o .= self::tlv('dmap.supportsindex', 0);
$o .= self::tlv('dmap.supportsextensions', 0);
$o .= self::tlv('dmap.timeoutinterval', 1800);
if (AmpConfig::get('daap_pass')) {
$o .= self::tlv('dmap.loginrequired', 1);
}
$o .= self::tlv('dmap.supportsquery', 0);
$o .= self::tlv('dmap.itemname', 'Ampache');
$o .= self::tlv('dmap.supportsbrowse', 0);
$o .= self::tlv('dmap.protocolversion', '0.2.0.0');
$o .= self::tlv('dmap.databasescount', 1);
$o = self::tlv('dmap.serverinforesponse', $o);
self::apiOutput($o);
}
/**
* content_codes
*
*/
public static function content_codes($input)
{
$o = self::tlv('dmap.status', 200);
foreach (self::$tags as $name => $tag) {
$entry = self::tlv('dmap.contentcodesname', $name);
$pcode = str_split($tag['code']);
$icode = (ord($pcode[0])<<24) + (ord($pcode[1])<<16) + (ord($pcode[2])<<8) + ord($pcode[3]);
$entry .= self::tlv('dmap.contentcodesnumber', $icode);
$entry .= self::tlv('dmap.contentcodestype', self::get_type_id($tag['type']));
$o .= self::tlv('dmap.dictionary', $entry);
}
$o = self::tlv('dmap.contentcodesresponse', $o);
self::apiOutput($o);
}
/**
* login
*
*/
public static function login($input)
{
self::check_auth('dmap.loginresponse');
// Create a new daap session
$sql = "INSERT INTO `daap_session` (`creationdate`) VALUES (?)";
Dba::write($sql, array(time()));
$sid = Dba::insert_id();
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('dmap.sessionid', $sid);
$o = self::tlv('dmap.loginresponse', $o);
self::apiOutput($o);
}
private static function check_session($code)
{
// Purge expired sessions
$sql = "DELETE FROM `daap_session` WHERE `creationdate` < ?";
Dba::write($sql, array(time() - 1800));
self::check_auth($code);
if (!isset($_GET['session-id'])) {
debug_event('daap', 'Missing session id.', '');
} else {
$sql = "SELECT * FROM `daap_session` WHERE `id` = ?";
$db_results = Dba::read($sql, array($_GET['session-id']));
if (Dba::num_rows($db_results) == 0) {
debug_event('daap', 'Unknown session id `' . $_GET['session-id'] . '`.', '4');
}
}
}
private static function check_auth($code = '')
{
$authenticated = false;
$pass = AmpConfig::get('daap_pass');
// DAAP password specified, need to authenticate the client
if (!empty($pass)) {
$headers = apache_request_headers();
$auth = $headers['Authorization'];
if (strpos(strtolower($auth), 'basic') === 0) {
$decauth = base64_decode(substr($auth, 6));
$userpass = split(':', $decauth);
if (count($userpass) == 2) {
if ($userpass[1] == $pass) {
$authenticated = true;
}
}
}
} else {
$authenticated = true;
}
if (!$authenticated) {
debug_event('daap', 'Authentication failed. Wrong DAAP password?', '5');
if (!empty($code)) {
self::createApiError($code, 403);
}
}
}
/**
* logout
*
*/
public static function logout($input)
{
self::check_auth();
$sql = "DELETE FROM `daap_session` WHERE `id` = ?";
Dba::write($sql, array($input['session-id']));
self::setHeaders();
header("HTTP/1.0 204 Logout Successful", true, 204);
}
/**
* update
*
*/
public static function update($input)
{
self::check_session('dmap.updateresponse');
$o = self::tlv('dmap.serverrevision', Catalog::getLastUpdate());
$o .= self::tlv('dmap.status', 200);
$o = self::tlv('dmap.updateresponse', $o);
self::apiOutput($o);
}
/**
* update
*
*/
public static function databases($input)
{
//$revision = $_GET['revision-number'];
$o = '';
// Database list
if (count($input) == 0) {
self::check_session('daap.serverdatabases');
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('dmap.updatetype', 0);
$o .= self::tlv('dmap.specifiedtotalcount', 1);
$o .= self::tlv('dmap.returnedcount', 1);
$r = self::tlv('dmap.itemid', 1);
$r .= self::tlv('dmap.itemname', 'Ampache');
$counts = Catalog::count_medias();
$r .= self::tlv('dmap.itemcount', $counts['songs']);
$r .= self::tlv('dmap.containercount', count(Playlist::get_playlists()));
$r = self::tlv('dmap.listingitem', $r);
$o .= self::tlv('dmap.listing', $r);
$o = self::tlv('daap.serverdatabases', $o);
} elseif (count($input) == 2) {
if ($input[1] == 'items') {
// Songs list
self::check_session('daap.playlistsongs');
//$type = $_GET['type'];
$meta = explode(',', strtolower($_GET['meta']));
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('dmap.updatetype', 0);
$songs = array();
$catalogs = Catalog::get_catalogs();
foreach ($catalogs as $catalog_id) {
$catalog = Catalog::create_from_id($catalog_id);
$songs = array_merge($songs, $catalog->get_songs());
}
$o .= self::tlv('dmap.specifiedtotalcount', count($songs));
$o .= self::tlv('dmap.returnedcount', count($songs));
$o .= self::tlv('dmap.listing', self::tlv_songs($songs, $meta));
$o = self::tlv('daap.playlistsongs', $o);
} elseif ($input[1] == 'containers') {
// Playlist list
self::check_session('daap.databaseplaylists');
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('dmap.updatetype', 0);
$playlists = Playlist::get_playlists();
$searches = Search::get_searches();
$o .= self::tlv('dmap.specifiedtotalcount', count($playlists) + count($searches));
$o .= self::tlv('dmap.returnedcount', count($playlists) + count($searches));
$l = '';
foreach ($playlists as $playlist_id) {
$playlist = new Playlist($playlist_id);
$playlist->format();
$l .= self::tlv_playlist($playlist);
}
foreach ($searches as $search_id) {
$playlist = new Search($search_id, 'song');
$playlist->format();
$l .= self::tlv_playlist($playlist);
}
$o .= self::tlv('dmap.listing', $l);
$o = self::tlv('daap.databaseplaylists', $o);
}
} elseif (count($input) == 3) {
// Stream
if ($input[1] == 'items') {
$finfo = explode('.', $input[2]);
if (count($finfo) == 2) {
$id = intval($finfo[0]);
$type = $finfo[1];
$params = '';
$headers = apache_request_headers();
$client = $headers['User-Agent'];
if (!empty($client)) {
$params .= '&client=' . $client;
}
$params .= '&transcode_to=' . $type;
$url = Song::play_url($id, $params, 'api', true);
self::follow_stream($url);
exit;
}
}
} elseif (count($input) == 4) {
// Playlist
if ($input[1] == 'containers' && $input[3] == 'items') {
$id = intval($input[2]);
self::check_session('daap.playlistsongs');
if ($id > Daap_Api::AMPACHEID_SMARTPL) {
$id -= Daap_Api::AMPACHEID_SMARTPL;
$playlist = new Search($id, 'song');
} else {
$playlist = new Playlist($id);
}
if ($playlist->id) {
$meta = explode(',', strtolower($_GET['meta']));
$o = self::tlv('dmap.status', 200);
$o .= self::tlv('dmap.updatetype', 0);
$items = $playlist->get_items();
$song_ids = array();
foreach ($items as $item) {
if ($item['object_type'] == 'song') {
$song_ids[] = $item['object_id'];
}
}
if (AmpConfig::get('memory_cache')) {
Song::build_cache($song_ids);
}
$songs = array();
foreach ($song_ids as $song_id) {
$songs[] = new Song($song_id);
}
$o .= self::tlv('dmap.specifiedtotalcount', count($songs));
$o .= self::tlv('dmap.returnedcount', count($songs));
$o .= self::tlv('dmap.listing', self::tlv_songs($songs, $meta));
$o = self::tlv('daap.databaseplaylists', $o);
} else {
self::createApiError('daap.playlistsongs', 500, 'Invalid playlist id: ' . $id);
}
}
}
self::apiOutput($o);
}
private static function tlv_songs($songs, $meta)
{
$lo = '';
foreach ($songs as $song) {
$song->format();
$o = self::tlv('dmap.itemkind', 2);
$o .= self::tlv('dmap.itemid', $song->id);
foreach ($meta as $m) {
switch ($m) {
case 'dmap.itemname':
$o .= self::tlv($m, $song->f_title);
break;
/*case 'dmap.persistentid':
$o .= self::tlv($m, $song->id);
break;*/
case 'daap.songalbum':
$o .= self::tlv($m, $song->f_album);
break;
case 'daap.songartist':
$o .= self::tlv($m, $song->f_artist);
break;
case 'daap.songbitrate':
$o .= self::tlv($m, intval($song->bitrate / 1000));
break;
case 'daap.songcomment':
$o .= self::tlv($m, $song->comment);
break;
case 'daap.songdateadded':
$o .= self::tlv($m, $song->addition_time);
break;
case 'daap.songdatemodified':
if ($song->update_time) {
$o .= self::tlv($m, $song->update_time);
}
break;
case 'daap.songdiscnumber':
$album = new Album($song->album);
$o .= self::tlv($m, $album->disk);
break;
case 'daap.songformat':
$o .= self::tlv($m, $song->type);
break;
case 'daap.songgenre':
$o .= self::tlv($m, Tag::get_display($song->tags, false, 'song'));
break;
case 'daap.songsamplerate':
$o .= self::tlv($m, $song->rate);
break;
case 'daap.songsize':
$o .= self::tlv($m, $song->size);
break;
case 'daap.songtime':
$o .= self::tlv($m, $song->time * 1000);
break;
case 'daap.songtracknumber':
$o .= self::tlv($m, $song->track);
break;
case 'daap.songuserrating':
$rating = new Rating($song->id, "song");
$rating_value = $rating->get_average_rating();
$o .= self::tlv($m, $rating_value);
break;
case 'daap.songyear':
$o .= self::tlv($m, $song->year);
break;
}
}
$lo .= self::tlv('dmap.listingitem', $o);
}
return $lo;
}
public static function tlv_playlist($playlist)
{
$isSmart = false;
if (strtolower(get_class($playlist)) == 'search') {
$isSmart = true;
}
$p = self::tlv('dmap.itemid', (($isSmart) ? Daap_Api::AMPACHEID_SMARTPL : 0) + $playlist->id);
$p .= self::tlv('dmap.itemname', $playlist->f_name);
$p .= self::tlv('dmap.itemcount', count($playlist->get_items()));
if ($isSmart) {
$p .= self::tlv('com.apple.itunes.smart-playlist', 1);
}
return self::tlv('dmap.listingitem', $p);
}
private static function tlv($tag, $value)
{
if (array_key_exists($tag, self::$tags)) {
$code = self::$tags[$tag]['code'];
switch (self::$tags[$tag]['type']) {
case 'byte':
return self::tlv_byte($code, $value);
case 'short':
return self::tlv_short($code, $value);
case 'int':
return self::tlv_int($code, $value);
case 'long':
return self::tlv_long($code, $value);
case 'string':
return self::tlv_string($code, $value);
case 'date':
return self::tlv_date($code, $value);
case 'version':
return self::tlv_version($code, $value);
case 'list':
return self::tlv_list($code, $value);
default:
debug_event('daap', 'Unsupported tag type `' . self::$tags[$tag]['type'] . '`.', '5');
break;
}
return $code . pack("N", strlen($value)) . $value;
} else {
debug_event('daap', 'Unknown DAAP tag `' . $tag . '`.', '5');
}
return '';
}
private static function tlv_string($tag, $value)
{
return $tag . pack("N", strlen($value)) . $value;
}
private static function tlv_long($tag, $value)
{
// Really?! PHP...
// Need to split value into two 32-bit integer because php pack function doesn't support 64-bit integer...
$highMap = 0xffffffff00000000;
$lowMap = 0x00000000ffffffff;
$higher = ($value & $highMap) >>32;
$lower = $value & $lowMap;
return $tag . "\0\0\0\8" . pack("NN", $higher, $lower);
}
private static function tlv_int($tag, $value)
{
return $tag . "\0\0\0\4" . pack("N", $value);
}
private static function tlv_short($tag, $value)
{
return $tag . "\0\0\0\2" . pack("n", $value);
}
private static function tlv_byte($tag, $value)
{
return $tag . "\0\0\0\1" . pack("C", $value);
}
private static function tlv_version($tag, $value)
{
$v = explode('.', $value);
if (count($v) == 4) {
return $tag . "\0\0\0\4" . pack("C", $v[0]) . pack("C", $v[1]) . pack("C", $v[2]) . pack("C", $v[3]);
} else {
debug_event('daap', 'Malformed `' . $tag . '` version `' . $value . '`.', '5');
}
return '';
}
private static function tlv_date($tag, $value)
{
return self::tlv_int($tag, $value);
}
private static function tlv_list($tag, $value)
{
return self::tlv_string($tag, $value);
}
public static function create_dictionary()
{
self::add_dict('mdcl', 'list', 'dmap.dictionary'); // a dictionary entry
self::add_dict('mstt', 'int', 'dmap.status'); // the response status code, these appear to be http status codes
self::add_dict('miid', 'int', 'dmap.itemid'); // an item's id
self::add_dict('minm', 'string', 'dmap.itemname'); // an items name
self::add_dict('mikd', 'byte', 'dmap.itemkind'); // the kind of item. So far, only '2' has been seen, an audio file?
self::add_dict('mper', 'long', 'dmap.persistentid'); // a persistent id
self::add_dict('mcon', 'list', 'dmap.container'); // an arbitrary container
self::add_dict('mcti', 'int', 'dmap.containeritemid'); // the id of an item in its container
self::add_dict('mpco', 'int', 'dmap.parentcontainerid');
self::add_dict('msts', 'string', 'dmap.statusstring');
self::add_dict('mimc', 'int', 'dmap.itemcount'); // number of items in a container
self::add_dict('mrco', 'int', 'dmap.returnedcount'); // number of items returned in a request
self::add_dict('mtco', 'int', 'dmap.specifiedtotalcount'); // number of items in response to a request
self::add_dict('mctc', 'int', 'dmap.containercount');
self::add_dict('mlcl', 'list', 'dmap.listing'); // a list
self::add_dict('mlit', 'list', 'dmap.listingitem'); // a single item in said list
self::add_dict('mbcl', 'list', 'dmap.bag');
self::add_dict('mdcl', 'list', 'dmap.dictionary');
self::add_dict('msrv', 'list', 'dmap.serverinforesponse'); // response to a /server-info
self::add_dict('msau', 'byte', 'dmap.authenticationmethod');
self::add_dict('mslr', 'byte', 'dmap.loginrequired');
self::add_dict('mpro', 'version', 'dmap.protocolversion');
self::add_dict('apro', 'version', 'daap.protocolversion');
self::add_dict('msal', 'byte', 'dmap.supportsuatologout');
self::add_dict('msup', 'byte', 'dmap.supportsupdate');
self::add_dict('mspi', 'byte', 'dmap.supportspersistentids');
self::add_dict('msex', 'byte', 'dmap.supportsextensions');
self::add_dict('msbr', 'byte', 'dmap.supportsbrowse');
self::add_dict('msqy', 'byte', 'dmap.supportsquery');
self::add_dict('msix', 'byte', 'dmap.supportsindex');
self::add_dict('msrs', 'byte', 'dmap.supportsresolve');
self::add_dict('mstm', 'int', 'dmap.timeoutinterval');
self::add_dict('msdc', 'int', 'dmap.databasescount');
self::add_dict('mccr', 'list', 'dmap.contentcodesresponse'); // response to a /content-codes
self::add_dict('mcnm', 'int', 'dmap.contentcodesnumber'); // the four letter code
self::add_dict('mcna', 'string', 'dmap.contentcodesname'); // the full name of the code
self::add_dict('mcty', 'short', 'dmap.contentcodestype'); // the type of the code
self::add_dict('mlog', 'list', 'dmap.loginresponse'); // response to a /login
self::add_dict('mlid', 'int', 'dmap.sessionid'); // the session id for the login session
self::add_dict('mupd', 'list', 'dmap.updateresponse'); // response to a /update
self::add_dict('musr', 'int', 'dmap.serverrevision'); // revision to use for requests
self::add_dict('muty', 'byte', 'dmap.updatetype');
self::add_dict('mudl', 'list', 'dmap.deletedidlisting'); // used in updates?
self::add_dict('avdb', 'list', 'daap.serverdatabases'); // response to a /databases
self::add_dict('abpro', 'list', 'daap.databasebrowse');
self::add_dict('abal', 'list', 'daap.browsealbumlisting');
self::add_dict('abar', 'list', 'daap.browseartistlisting');
self::add_dict('abcp', 'list', 'daap.browsecomposerlisting');
self::add_dict('abgn', 'list', 'daap.browsegenrelisting');
self::add_dict('adbs', 'list', 'daap.databasesongs'); // response to a /databases/id/items
self::add_dict('asal', 'string', 'daap.songalbum');
self::add_dict('asar', 'string', 'daap.songartist');
self::add_dict('asbt', 'short', 'daap.songsbeatsperminute');
self::add_dict('asbr', 'short', 'daap.songbitrate');
self::add_dict('ascm', 'string', 'daap.songcomment');
self::add_dict('asco', 'byte', 'daap.songcompilation');
self::add_dict('asda', 'date', 'daap.songdateadded');
self::add_dict('asdm', 'date', 'daap.songdatemodified');
self::add_dict('asdc', 'short', 'daap.songdiscount');
self::add_dict('asdn', 'short', 'daap.songdiscnumber');
self::add_dict('asdb', 'byte', 'daap.songdisabled');
self::add_dict('aseq', 'string', 'daap.songqpreset');
self::add_dict('asfm', 'string', 'daap.songformat');
self::add_dict('asgn', 'string', 'daap.songgenre');
self::add_dict('asdt', 'string', 'daap.songdescription');
self::add_dict('asrv', 'byte', 'daap.songrelativevolume');
self::add_dict('assr', 'int', 'daap.songsamplerate');
self::add_dict('assz', 'int', 'daap.songsize');
self::add_dict('asst', 'int', 'daap.songstarttime'); // in milliseconds
self::add_dict('assp', 'int', 'daap.songstoptime'); // in milliseconds
self::add_dict('astm', 'int', 'daap.songtime'); // in milliseconds
self::add_dict('astc', 'short', 'daap.songtrackcount');
self::add_dict('astn', 'short', 'daap.songtracknumber');
self::add_dict('asur', 'byte', 'daap.songuserrating');
self::add_dict('asyr', 'short', 'daap.songyear');
self::add_dict('asdk', 'byte', 'daap.songdatakind');
self::add_dict('asul', 'string', 'daap.songdataurl');
self::add_dict('aply', 'list', 'daap.databaseplaylists'); // response to a /databases/id/containers
self::add_dict('abpl', 'byte', 'daap.baseplaylist');
self::add_dict('apso', 'list', 'daap.playlistsongs'); // response to a /databases/id/containers/id/items
self::add_dict('prsv', 'list', 'daap.resolve');
self::add_dict('arif', 'list', 'daap.resolveinfo');
self::add_dict('aeNV', 'int', 'com.apple.itunes.norm-volume');
self::add_dict('aeSP', 'byte', 'com.apple.itunes.smart-playlist');
}
private static function add_dict($code, $type, $name)
{
self::$tags[$name] = array('type' => $type,
'code' => $code
);
}
private static function get_type_id($type)
{
switch ($type) {
case 'byte':
return 1;
case 'unsigned byte':
return 2;
case 'short':
return 3;
case 'unsigned short':
return 4;
case 'int':
return 5;
case 'unsigned int':
return 6;
case 'long':
return 7;
case 'unsigned long':
return 8;
case 'string':
return 9;
case 'date': // represented as a 4 byte integer
return 10;
case 'version': // represented as a 4 singles bytes, e.g. 0.1.0.0 or as two shorts, e.g. 1.0
return 11;
case 'list':
return 12;
default:
return 0;
}
}
private static function setHeaders()
{
header("Content-Type: application/x-dmap-tagged");
header("DAAP-Server: Ampache");
header("Accept-Ranges: bytes");
header("Cache-Control: no-cache");
header("Expires: -1");
}
public static function apiOutput($string)
{
self::setHeaders();
if ($_SERVER['REQUEST_METHOD'] != 'OPTIONS') {
header("Content-length: " . strlen($string));
echo $string;
} else {
header("Content-type: text/plain", true);
header("Content-length: 0", true);
}
}
public static function createError($code)
{
$error = "";
switch ($code) {
case 404:
$error = "Not Found";
break;
case 401:
$error = "Unauthorized";
break;
}
header("Content-type: text/html", true);
header("HTTP/1.0 ". $code . " " . $error, true, $code);
$html = "<html><head><title>" . $error . "</title></head><body><h1>" . $code . " " . $error . "</h1></body></html>";
self::apiOutput($html);
exit();
}
public static function createApiError($tag, $code, $msg='')
{
$o = self::tlv('dmap.status', $code);
if (!empty($msg)) {
$o .= self::tlv('dmap.statusstring', $msg);
}
$o = self::tlv($tag, $o);
self::apiOutput($o);
exit();
}
}