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

作者: WilburLi | 来源:发表于2018-01-29 21:09 被阅读3732次

前言

投屏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/

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

前言

追加问题非常SORRY：

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

优秀文章

camera

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

前言

追加问题 非常SORRY：

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

优秀文章

camera

追加问题非常SORRY：