iOS DLNA Cyberlink，PlatinumKit庫完成DLNA功能

   通過一個多月的研究，終於將iOS DLNA搞定。記錄一下。

   關於DLNA開發，目前有兩個框架。一個Cyberlink，一個platinumkit。Cyberlink的好處就是提供了一套OC的api供你調用，很簡單方便。可是此框架有不少問題，且功能不全。platinumkit框架底層爲c++，若要用此套框架，就得進行oc和c++的混編，以前我沒作過oc和c++的混編，因此去看platinumkit的源碼時，以爲頭疼無比，浪費了不少時間，可是使用cyberlink框架又有不少功能沒法解決，而且框架常常出問題。最後完成DMC部分的時候仍是用了cyberlink，有問題怎麼辦，只能硬着頭皮改源碼了。好在最後仍是搞定了。

   1.DMS

      首先讓手機本身具備DMS的功能，此處用的Platinumkit框架。github上有個demo ：https://github.com/wangshuaidavid/DLNA_iOS_Platinum，當時主要就是依賴於這個demo完成了手機dms部分的功能。關於platinumkit庫的使用，網上有教程，你們能夠參考，就是編譯一個.a的文件出來，而後拉進本身的項目。.a的文件分模擬器和真機兩個，能夠經過終端合成一個。關於DMS部分沒什麼好說的，主要看那個demo就行了。

   2.DMC，DMR

     使用cyberlink庫完成dmc功能，github上有個demo：https://github.com/FuruyamaTakeshi/DLNA。此demo完成了基本的dmc功能，能夠搜索同一局域網內的dms，dmr。

 

    CGUpnpAvController* avCtrl = [[CGUpnpAvController alloc] init];
    avCtrl.delegate = self;
    [avCtrl search];
    self.avController = avCtrl;

      這個CGupnpAVController類就是關於搜索dms，dmr的類。經過avCtrl能夠獲取到對應的dms，而後對dms發送瀏覽文件的action，返回來文件內容，最後一直拿到AVitem，即資源文件的地址。而後dmr獲取到這個資源文件地址之後，經過setAVTransportURI去設置真實的dmr設備的請求地址。設置成功後play就能夠播放了。可能看到這裏會以爲很簡單，可是cyberlink的dmr只提供了play，stop，pause，next，previous，seek方法，而且next，previous等方法是沒用的。若是你想完成多一些功能，要麼就去用platinumkit框架，要麼就本身動手給dmr添加這些功能。我選了後者。

      要想改源碼首先要搞懂整個DLNA的工做原理。詳細的工做原理我也講不明白，我只是在研究這兩個框架的時候，本身慢慢的明白了一些。

      首先不管是dms，仍是dmr，都是一個device，經過代碼也能看出這點。CGUpnpAVServer，CGUpnpAvRender都是繼承自CGUpnpDevice的。CGUpnpDevice包含一個CgUpnpDevice的結構體。而這個CGUpnpDevice類就是咱們去構造DMS，DMR的關鍵。CGUpnpDevice這個類有一個方法，initWithXMLDescription。即經過一個xml來建立一個device。當你使用dms的標準xml去建立device時，它就是dms。當你使用dmr的標準xml去建立device時，它就是dmr。兩個建立device的xml分別以下

- (NSString *)getDMSDespritionXMl1000000000:(NSString *)uuid
{
    return [NSString stringWithFormat:@"<?xml version='1.0' encoding='utf-8' standalone='yes'?><root xmlns='urn:schemas-upnp-org:device-1-0'><specVersion><major>1</major><minor>0</minor></specVersion><device><deviceType>urn:schemas-upnp-org:device:MediaServer:1</deviceType><manufacturer>Plutinosoft LLC</manufacturer><manufacturerURL>http://www.plutinosoft.com</manufacturerURL><modelDescription>Plutinosoft AV Media Server Device</modelDescription><modelName>AV Media Server Device</modelName><modelURL>http://www.plutinosoft.com/platinum</modelURL><UDN>uuid:%@</UDN><dlna:X_DLNADOC xmlns:dlna='urn:schemas-dlna-org:device-1-0'>DMS-1.50</dlna:X_DLNADOC><serviceList><service><serviceType>urn:microsoft.com:service:X_MS_MediaReceiverRegistrar:1</serviceType><serviceId>urn:microsoft.com:serviceId:X_MS_MediaReceiverRegistrar</serviceId><SCPDURL>/X_MS_MediaReceiverRegistrar/%@/scpd.xml</SCPDURL><controlURL>/X_MS_MediaReceiverRegistrar/%@/control.xml</controlURL><eventSubURL>/X_MS_MediaReceiverRegistrar/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:ContentDirectory:1</serviceType><serviceId>urn:upnp-org:serviceId:ContentDirectory</serviceId><SCPDURL>/ContentDirectory/%@/scpd.xml</SCPDURL><controlURL>/ContentDirectory/%@/control.xml</controlURL><eventSubURL>/ContentDirectory/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:ConnectionManager:1</serviceType><serviceId>urn:upnp-org:serviceId:ConnectionManager</serviceId><SCPDURL>/ConnectionManager/%@/scpd.xml</SCPDURL><controlURL>/ConnectionManager/%@/control.xml</controlURL><eventSubURL>/ConnectionManager/%@/event.xml</eventSubURL></service></serviceList></device></root>",uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid];
}

 

- (NSString *)getDMRDescriptionXml11111:(NSString *)uuid
{
    return [NSString stringWithFormat:@"<?xml version='1.0' encoding='UTF-8'?><root xmlns='urn:schemas-upnp-org:device-1-0' xmlns:dlna='urn:schemas-dlna-org:device-1-0'><specVersion><major>1</major><minor>0</minor></specVersion><device><deviceType>urn:schemas-upnp-org:device:MediaRenderer:1</deviceType><friendlyName>hitv_dmr</friendlyName><manufacturer>Plutinosoft LLC</manufacturer><manufacturerURL>http://www.plutinosoft.com</manufacturerURL><modelDescription>Plutinosoft AV Media Renderer Device</modelDescription><modelName>AV Renderer Device</modelName><modelURL>http://www.plutinosoft.com/platinum</modelURL><serialNumber></serialNumber><UDN>uuid:%@</UDN><dlna:X_DLNADOC xmlns:dlna='urn:schemas-dlna-org:device-1-0'>DMR-1.50</dlna:X_DLNADOC><serviceList><service><serviceType>urn:schemas-upnp-org:service:AVTransport:1</serviceType><serviceId>urn:upnp-org:serviceId:AVTransport</serviceId><SCPDURL>/AVTransport/%@/scpd.xml</SCPDURL><controlURL>/AVTransport/%@/control.xml</controlURL><eventSubURL>/AVTransport/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:ConnectionManager:1</serviceType><serviceId>urn:upnp-org:serviceId:ConnectionManager</serviceId><SCPDURL>/ConnectionManager/%@/scpd.xml</SCPDURL><controlURL>/ConnectionManager/%@/control.xml</controlURL><eventSubURL>/ConnectionManager/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:RenderingControl:1</serviceType><serviceId>urn:upnp-org:serviceId:RenderingControl</serviceId><SCPDURL>/RenderingControl/%@/scpd.xml</SCPDURL><controlURL>/RenderingControl/%@/control.xml</controlURL><eventSubURL>/RenderingControl/%@/event.xml</eventSubURL></service></serviceList></device></root>",uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid,uuid];
}
 

   此處的uuid都未設備的uuid。經過xml建立好device後，還須要給device設置friendlyName和loactionurl。在cyberlink庫裏是沒有提供設置locationurl的方法，因此得本身加一個。

- (void)setLocationURL:(NSString *)url
{
    if (!cObject) {
        return ;
    }
    cg_upnp_device_setlocationfromssdppacket(cObject, (char *)[url UTF8String]);
}

 這個cg_upnp_device_setlocationfromssdppacket方法也是本身加到庫裏去的。看起來比較麻煩，其實很簡單，就是經過device的sspdPacket去修改loactionurl。改好這些之後，你的device就創建立好了，這時候經過dms或dmr對應的initWithcObject方法就能夠建立好dms或者dmr了。爲何要本身去建立dms或者dmr呢。這是由於我本身開發的須要，我這邊不能使用CGupnpAvController這個類去搜索dms或者dmr，因此只能本身去主動建立了，若是你的需求是作正常的搜索功能，不須要這麼去作，可是我說這些是爲了講我對於dms，dmr的一些理解。

    如今咱們來看，dmr是怎麼播放的。

if ([self.renderer setAVTransportWithItem:self.avItem]) {
        [self.renderer playWithUrl:[self.avItem.resourceUrl description]];
        self.isPlay = [self.renderer isPlaying];
    }

 就是這幾行代碼，dmr就播放了對應的dms的資源文件。跟進去這個setAVTransportWithItem方法，發現它主要是爲了獲取一個aciton，再跟進去，發現先獲取一個service。這個service和咱們的dms是不同的。這個service是一個device的service。咱們再能夠去看建立device的xml。xml裏包含了一些device的基本信息，同時包含了一個servicelist！就是這個servicelist。

<serviceList><service><serviceType>urn:schemas-upnp-org:service:AVTransport:1</serviceType><serviceId>urn:upnp-org:serviceId:AVTransport</serviceId><SCPDURL>/AVTransport/%@/scpd.xml</SCPDURL><controlURL>/AVTransport/%@/control.xml</controlURL><eventSubURL>/AVTransport/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:ConnectionManager:1</serviceType><serviceId>urn:upnp-org:serviceId:ConnectionManager</serviceId><SCPDURL>/ConnectionManager/%@/scpd.xml</SCPDURL><controlURL>/ConnectionManager/%@/control.xml</controlURL><eventSubURL>/ConnectionManager/%@/event.xml</eventSubURL></service><service><serviceType>urn:schemas-upnp-org:service:RenderingControl:1</serviceType><serviceId>urn:upnp-org:serviceId:RenderingControl</serviceId><SCPDURL>/RenderingControl/%@/scpd.xml</SCPDURL><controlURL>/RenderingControl/%@/control.xml</controlURL><eventSubURL>/RenderingControl/%@/event.xml</eventSubURL></service></serviceList>

這下應該明白了，每一個device裏都有一個servicelist，經過名稱獲取到對應的service，而後再經過service獲取到你想要的action，而後再把action post出去，咱們的真實設備就能夠在局域網裏收到這個action，響應動做。包括dms，也是同樣的工做原理，經過post action，去獲取dms裏的文件目錄。

    那麼咱們要如何給dmr添加咱們想要的快進，快退，調節音量等功能呢？    你仔細看這個servicelist，裏面有幾個xml的路徑，你的locationurl地址在加上xml路徑，而後在瀏覽器裏打開（在火狐瀏覽器打開）。其中一個就有actionlist，actionlist裏包含各類aciton，而後你就能夠本身去主動獲取這些action，而後post出去，去給本身的dmr加本身想要的功能。

    ps：cyberlink裏有一些坑，我也記得不太清楚了，能補充多少是多少。

    1：setAVTRansportURI這個方法裏面沒有去區分item的類別，好比是音樂仍是圖片仍是視頻，須要本身去改一下。我改爲了setAVTransportWithItem，把AVItem傳進去，而後去判斷item的類型

- (BOOL)setAVTransportWithItem:(CGUpnpAvItem *)item
{
    CGUpnpAction *action = [self actionOfTransportServiceForName:@"SetAVTransportURI"];
    if (!action)
        return NO;
    [action setArgumentValue:@"0" forName:@"InstanceID"];
    [action setArgumentValue:[item.resourceUrl description] forName:@"CurrentURI"];
    NSString *classStr = [NSString string];
    if ([item isAudioClass]) 
        classStr = @"audioItem";
    }
    else if([item isVideoClass])
    {
        classStr = @"videoItem";
    }
    else if([item isImageClass])
    {
        classStr = @"imageItem";
    }
    [action setArgumentValue:[self getCurrentURIMetaData:[item.resourceUrl description] With:classStr] forName:@"CurrentURIMetaData"];
    if (![action post])
        return NO;
    
    return YES;
}

   2：在建立device的時候，其實你的servicelist沒有被初始化，具體的緣由是什麼我也不清楚，多是框架自己的缺陷。因此須要本身主動的去初始化一次。

首先你去獲取service，而後從service裏獲取action時，你會發現service裏的actionlist要麼是空，要麼只有一個action，跟進去getActionForName方法，把

#ifdef CG_OPTIMIZED_CP_MODE 這行注掉，這個時候它就會去判斷是否service被初始化過，沒有就初始化一次。固然這樣作仍是不保險，最好能本身在建立device後主動初始化一次servicelist。因此我在CGUpnpDevice裏添加了一個初始化servicelist的方法

- (void)parisedSCPDUrl
{
    if (!cObject) {
        return ;
    }
    NSArray *servise = self.services;
    for (int i = 0; i < servise.count; i++) {
        CGUpnpService *ser = servise[i];
        cg_upnp_controlpoint_parsescservicescpd(ser.cObject);
    }
}

 這樣就沒問題了。這樣每次當你去獲取action的時候，裏面servicelist都已經被初始化了，不會有action取不到的狀況。

  3：不少關於網絡請求的地方都是沒有用多線程的，好比去初始化這個servicelist，最好能本身在加一個異步的操做，避免阻塞主線程。

  目前能想到的就這麼多了，確實cyberlink坑比較多，一開始完成正常的dms，dmc等功能其實挺快的，可是咱們的需求不同，不容許讓dms，dmr暴露在局域網裏，因此只能去主動構建，爲了這個需求走了好多彎路，一直研究了一個多月才搞定，寫篇博文保留一下當時的研究過程。。。。