投屏Cling DLNA 播放本地/网络资源方法梳理

前言

投屏APP市面上已经不少，而且大多数视频播放软件也都支持此功能，然而上网一查相关中文资源却千篇一律，代码大多出自于一处，相互效仿，外文资源却又开的不是很明白，最终 左找右找拼凑出了一个真正可以用的DEMO 现做以总结，梳理逻辑~

一、概念：
我就不从头说起了，直接介绍DLNA、UPNP、CLING；
最始做投屏时 只知道 DLNA是做投屏的标准，由微软、因特尔、索尼等几家大公司搞出可以与电视等实现交互，后来再深入学习实现时发现 代码中反复应用到UPNP服务，当时也没多想什么就往下做了下去，不过在写完SDK封装后在给下边的同事讲解时 这里却没有说明白，现回头总结一下他们之间的关系


image.png

如图所示，UPnP属于DLNA分层架构中的第三层（Device Discovery&Control），它属于DLNA的基础协议框架，DLNA用UPnP协议来实现设备的发现和控制。

说白了，就是DLNA其实就是能用标准的名称，他采用的是UPNP标准协议来实现的，而CLING是实现这一系列的第三方库。

最终选用CLING来实现投屏功能也是试过其它库，觉得这个相对好实现，而且网上资源相对其它库更多一些（入门级的资源多）。

二、DLNA 分类：
关于这里是让我这个初学者转圈的地方，我们的需求是要实现本地资源播放，而最初查到的国内资源都是只实现了播放网络视频，实现相对简单，关于这类文章的作者也许也不知道怎么实现本地资源，也就无从知道这里的分类了，而恰恰是这些分类表明了DLNA使用的广泛：

  • Digital Media Server（DMS）数位媒体服务器: 提供了媒体档案的获取、录制、储存以及作为源头的装置。

  • Digital Media Player（DMP）数位媒体播放器: 可寻找并播放或输出任何由DMS所提供的媒体档案的装置。

  • Digital Media Controller（DMC）数位媒体控制器: 作为遥控装置使用，可寻找DMS上的多媒体档案，并指定可播放该多媒体档案的DMR进行播放或是控制多媒体档案上下传到DMS的装置。

  • Digital Media Renderer（DMR）数位媒体控制器: 可接收并播放从DMC push过来的媒体档案。

DMS 与 DMC是我这次项目主要用到的，播放网络文件没有那么多讲究了，最多用到DMC进行控制播放，而本地播放需要将自己的手机创建为一个局域网中的设备服务，供另一端读取播放，知道了这一点，投屏本地资源就清楚的多了，接下来我们说说怎么实现

三、实现

实现分为三步骤：

  • 发现设备并与之连接
  • 播放
  • 控制

步骤一：发现设备与之连接

首先是需要用到的权限

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>

因为DLNA使用的是标准UPNP协议，当然一切就都将由UPNP开始,分别的含义也如下：

...
//添加服务设备
sUpnpService.getRegistry().addDevice(sMediaServer.getDevice());
//添加对UPNP服务的监听局域网内有哪些支持DLNA的设备
sUpnpService.getRegistry().addListener(sRegistryListener);
//开始发现设备
sUpnpService.getControlPoint().search();
...

查找到的设备 将会在sRegistryListener中回调，回调代码如下：

private static BrowseRegistryListener sRegistryListener = new BrowseRegistryListener();

public class BrowseRegistryListener extends DefaultRegistryListener {

    private ArrayList<Device> mDeviceList;

    public  BrowseRegistryListener(ArrayList<Device> deviceList){
        mDeviceList = deviceList;
    }

    @Override
    public void deviceAdded(Registry registry, Device device) {
        super.deviceAdded(registry, device);
        mDeviceList.add(device);
    }

    @Override
    public void deviceRemoved(Registry registry, Device device) {
        super.deviceRemoved(registry, device);
        mDeviceList.remove(device);
    }
}

由此，开启了DLNA之路

步骤二：播放

说完 查找设备 在上面的代码中，不知道有注意与其相关的另外的两行代码没有,
sUpnpService.getRegistry().addDevice(sMediaServer.getDevice());
sUpnpService.getControlPoint().search();

第一条语句过会再说，先看第二条search方法来源于getControlPoint，其实这就是我之前所说的DLNA的几大分类之一：DMC控制，有了他，我们可以控制与之连接的设备实现协定，播放，也是用到这个方法，通过upnpService得到ControlPoint对象后 可以执行如下代码：

sControlPoint.execute(new SetAVTransportURI(avtService, url,metadata) {
            @Override
            public void success(ActionInvocation invocation) {
                super.success(invocation);
            }

            @Override
            public void failure(ActionInvocation invocation, UpnpResponse operation, String defaultMsg) {
            }
        });

SetAVTransportURI 就是设置播放源信息，三个参数；

  • avtService 当前要播放设备的服务 device.findService(AV_TRANSPORT_SERVICE)可以得到
  • url 播放源地址 分为 网络播放与本地播放
  • metadata DLNA中的规范化XML 格式（硬性拷贝DEMO中的代码即可，没有太多要求）

注意 第一次播放使用 SetAVTransportURI，后继比如还有对视频，音频的暂停再播放会有另外的方法，代码如下

sControlPoint.execute(new Play(avtService) {
                @Override
                public void success(ActionInvocation invocation) {
                    super.success(invocation);
                }

                @Override
                public void failure(ActionInvocation actionInvocation, UpnpResponse upnpResponse, String s) {
                }
            });

 sControlPoint.execute(new Pause(avtService) {
                @Override
                public void success(ActionInvocation invocation) {
                    super.success(invocation);
                }

                @Override
                public void failure(ActionInvocation actionInvocation, UpnpResponse upnpResponse, String s) {
                }
            });

sControlPoint.execute(new Stop(avtService) {
                @Override
                public void success(ActionInvocation invocation) {
                    super.success(invocation);
                }

                @Override
                public void failure(ActionInvocation actionInvocation, UpnpResponse upnpResponse, String s) {
                }
            });

而对于图片，只有一张图片 所以每次都用SetAVTransportURI即可.

实现metadata 的 XML的方法代码如下：

...
String metadata = DlnaUtils.pushMediaToRender(url, "id", item.getTitle(), "0",item.getCreator());
...

public static String pushMediaToRender(String url, String id, String name, String duration,String creator) {
        long size = 0;
        long bitrate = 0;
        Res res = new Res(new MimeType(ProtocolInfo.WILDCARD, ProtocolInfo.WILDCARD), size, url);

        VideoItem videoItem = new VideoItem(id, "0", name, creator, res);

        String metadata = createItemMetadata(videoItem);
        DlnaLog.e(TAG, "metadata: " + metadata);
        return metadata;
    }

    public static String createItemMetadata(DIDLObject item) {
        StringBuilder metadata = new StringBuilder();
        metadata.append(DIDL_LITE_HEADER);

        metadata.append(String.format("<item id=\"%s\" parentID=\"%s\" restricted=\"%s\">", item.getId(), item.getParentID(), item.isRestricted() ? "1" : "0"));

        metadata.append(String.format("<dc:title>%s</dc:title>", item.getTitle()));
        String creator = item.getCreator();
        if (creator != null) {
            creator = creator.replaceAll("<", "_");
            creator = creator.replaceAll(">", "_");
        }
        metadata.append(String.format("<upnp:artist>%s</upnp:artist>", creator));
        metadata.append(String.format("<upnp:class>%s</upnp:class>", item.getClazz().getValue()));

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
        Date now = new Date();
        String time = sdf.format(now);
        metadata.append(String.format("<dc:date>%s</dc:date>", time));

        Res res = item.getFirstResource();
        if (res != null) {
            // protocol info
            String protocolinfo = "";
            ProtocolInfo pi = res.getProtocolInfo();
            if (pi != null) {
                protocolinfo = String.format("protocolInfo=\"%s:%s:%s:%s\"", pi.getProtocol(), pi.getNetwork(), pi.getContentFormatMimeType(), pi
                        .getAdditionalInfo());
            }
            DlnaLog.e(TAG, "protocolinfo: " + protocolinfo);

            // resolution, extra info, not adding yet
            String resolution = "";
            if (res.getResolution() != null && res.getResolution().length() > 0) {
                resolution = String.format("resolution=\"%s\"", res.getResolution());
            }

            // duration
            String duration = "";
            if (res.getDuration() != null && res.getDuration().length() > 0) {
                duration = String.format("duration=\"%s\"", res.getDuration());
            }

            // res begin
            //            metadata.append(String.format("<res %s>", protocolinfo)); // no resolution & duration yet
            metadata.append(String.format("<res %s %s %s>", protocolinfo, resolution, duration));

            // url
            String url = res.getValue();
            metadata.append(url);

            // res end
            metadata.append("</res>");
        }
        metadata.append("</item>");

        metadata.append(DIDL_LITE_FOOTER);

        return metadata.toString();
    }

好了，实现了基本的播放控制，回过头来再说刚才我们提到的第一行代码：sUpnpService.getRegistry().addDevice(sMediaServer.getDevice());
正常情况下 在设备监听的时候就已经可以得到所有支持DLNA设备了，但为什么这里还要手动添加一个设备呢？这就是本地源播放与网络源播放的差异，网络播放时的链接可以是这样："http://video19.ifeng.com/video07/2013/11/11/281708-102-007-1138.mp4" ，而本地播放时 也得需要这种格式，只写本地路径那肯定是不行的，实际应用中应该是这样：“http://192.168.199.148:8888/storage/emulated/0/DCIM/FaceMe/20171213-112507.mp4” 才可以被设备服务所识别，也就是说 要实现本地播放，首先要将手机设定成一个终端服务才可被投影设备调用，所以 sUpnpService.getRegistry().addDevice添加的就是这个我们手动创建的HTTP服务，然后将此服务所在的设备手动添加进去，也就是要投屏本地资源的手机。也只有这样 电视才能从我们的手机中得到资源并播放 创建本地服务代码如下

public MediaServer(Context context) throws ValidationException {
        mContext = context;
        DeviceType type = new UDADeviceType(deviceType, version);
        DeviceDetails details = new DeviceDetails("DMS  (" + android.os.Build.MODEL + ")", new ManufacturerDetails(
                android.os.Build.MANUFACTURER), new ModelDetails(android.os.Build.MODEL,DMS_DESC, "v1"));

        LocalService service = new AnnotationLocalServiceBinder().read(ContentDirectoryService.class);

        service.setManager(new DefaultServiceManager(service, ContentDirectoryService.class));

        localDevice = new LocalDevice(new DeviceIdentity(udn), type, details, createDefaultDeviceIcon(), service);

        Log.v(TAG, "MediaServer device created: ");
        Log.v(TAG, "friendly name: " + details.getFriendlyName());
        Log.v(TAG, "manufacturer: " + details.getManufacturerDetails().getManufacturer());
        Log.v(TAG, "model: " + details.getModelDetails().getModelName());

        try {
            // start http server
            mHttpServer = new HttpServer(PORT);
        } catch (IOException ioe) {
            DlnaLog.e(TAG,"Couldn't start server:\n" + ioe);
            System.exit(-1);
        }
        DlnaLog.e(TAG, "Started Http Server on port " + PORT);
    }

    public void stopServer(){
        try {
            if(mHttpServer!=null){
                mHttpServer.stop();
            }
            System.exit(-1);
        }catch (Exception ex){
            ex.printStackTrace();
        }
    }

步骤三： 控制

最后说一下控制，其实播放与控制就是算做一类，下面的代码是实现播放进度条的控制，其实实现起来和play stop pause 一样

//控制进度条
sControlPoint.execute(new Seek(avtService,time) {
                @Override
                public void success(ActionInvocation invocation) {
                    super.success(invocation);
                }

                @Override
                public void failure(ActionInvocation actionInvocation, UpnpResponse upnpResponse, String s) {
                }
            });

//控制是否禁音
            sControlPoint.execute(new SetMute(avtService,desiredMute) {
                @Override
                public void success(ActionInvocation invocation) {
                    super.success(invocation);
                }

                @Override
                public void failure(ActionInvocation actionInvocation, UpnpResponse upnpResponse, String s) {

                }
            });

当然 我所说的控制只是对视频、音频控制，我看还有一些应用 是靠DLNA实现遥控器的相关实现，这个不在我项目范围之内，我也就没有再研究。

最后总结，之前在投入投屏APP开发之中的种种疑惑 都在此文章中有所梳理，像VideoItem,ImageItem什么场合下使用哪一个 不用在意都一样XML里的写法也不用纠结，按那一套来就够用等等，希望对以后的我回已此项目有所帮助，也希望对大家有帮助。

追加问题 非常SORRY：

之前说VideoItem、ImageItem、MusicItem用哪个无所谓，在实际项目中发现 不同的类型在使用不称的item会出现 莫名其妙的错误，最常见的就是投着投着会有加载不出来的情况，在这种情况下，不管如何重启应用，甚至重启手机都会提示 播放错误 CODE 38.只有重启电视才好用。

所以 在调用pushMediaToRender方法时 一定传入相对应的类型以采用对应的Item。

DEMO地址：https://github.com/WilburLe/WClingDemo/

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 159,015评论 4赞 362
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 67,262评论 1赞 292
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 108,727评论 0赞 243
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 43,986评论 0赞 205
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,363评论 3赞 287
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,610评论 1赞 219
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,871评论 2赞 312
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,582评论 0赞 198
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,297评论 1赞 242
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2赞 246
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1赞 260
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,385评论 2赞 253
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 33,035评论 3赞 236
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0赞 195
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2赞 274
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2赞 270