Android基于Cling开发DLNA应用

简介:

# Android基于Cling开发DLNA应用

## DLNA

DLNA,Digital Living Network Alliance的简称,即数字生活网络联盟。其由消费性电子、移动电话以及电脑厂商组成。目标在于创建一套可以使得各厂商的产品互相连接,互相适应的工业标准,从而为消费者实现数字化生活。

更多资料:

1. About DLNA
2. 维基百科
3. 百度百科

## Cling

UPnP/DLNA library for Java and Android。

GitHub最多关注,当前仍在维护,许可协议为LGPL或CDDL。

用户手册:Cling on Android

以下为中文译文:

 
  1. ## 5. Android上的Cling 
  2. Cling Core为Android应用提供了UPnP栈。由于如今大部分Android系统都是小型手持设备,所以通常你需要写控制端应用。然而你也可以写Android上的UPnP服务应用,其所有特性Cling Core都支持。 
  3.  
  4. ``` 
  5. Android模拟器上的Cling 
  6. 在写此时,Android模拟器还不支持接收UDP组播。不过,可以发送UDP组播。你能够发送一个组播UPnP搜寻,并接收UDP单播回应,继而发现正运行的设备。你发现不了在搜寻后新开启的设备,并且在设备关闭时也收不到消息。另外,其他在你网络的控制端应用,则不能发现你本地的Android设备或服务。在你测试应用时,所有这些情况都会使你感到困惑,所以除非你真得理解哪些有作用、哪些没有,不然你应当使用一个真正的设备。 
  7. 这章阐述了你如何整合Cling到你的Android应用,使其成为一个共享的部件。 
  8. ``` 
  9.  
  10. ### 5.1. 配置应用服务 
  11. 你可以在Android应用主activity中实例化Cling UpnpService。另一方面,如果你好些activities都要要求访问UPnP栈,那么最好采用后台服务,android.app.Service。之后,任何想要访问UPnP栈的activity,都能够在需要时绑定或解绑该服务。 
  12.  
  13. 该服务组件的接口是org.teleal.cling.android.AndroidUpnpService: 
  14.  
  15. ``` 
  16. public interface AndroidUpnpService { 
  17.     public UpnpService get(); 
  18.     public UpnpServiceConfiguration getConfiguration(); 
  19.     public Registry getRegistry(); 
  20.     public ControlPoint getControlPoint(); 
  21. } 
  22. ``` 
  23.  
  24. activity通常访问已知UPnP设备的注册表,或者通过ControlPoint查询和控制UPnP设备。 
  25. 你必须在AndroidManifest.xml内配置内建的服务实现: 
  26.  
  27. ``` 
  28. <manifest ...> 
  29.  
  30.     <uses-permission android:name="android.permission.INTERNET"/> 
  31.     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> 
  32.     <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE"/> 
  33.     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
  34.  
  35.     <application ...> 
  36.  
  37.         <activity ...> 
  38.             ... 
  39.         </activity> 
  40.  
  41.         <service android:name="org.teleal.cling.android.AndroidUpnpServiceImpl"/> 
  42.  
  43.     </application> 
  44.  
  45. </manifest> 
  46. ``` 
  47.  
  48. 此Cling UPnP服务要求设备WiFi接口的访问权限,事实上其也只将会绑定网络接口。 
  49. 此服务将会自动检测WiFi接口的关闭,并优雅地处理这种情形:任何客户端操作都会导致"no response from server"状态,而你的代码必须预料并处理该状态。 
  50.  
  51. 当服务组件创建或销毁时,会相应开启和关闭UPnP系统。这依赖于在你的activities里是如何访问此组件的。 
  52.  
  53. ### 5.2 activity如何访问服务 
  54. service的生命周期在Android中很好的被定义了。如果service还没启动的话,第一个绑定服务的activity将会启动它。当不再有activity绑定到service上时,操作系统将会销毁此service。 
  55.  
  56. 让我们写一个简单的UPnP浏览activity。它用于将所有你网络内的设备显示在一个列表内,并有一个菜单选项来触发搜寻。activity连接UPnP服务之后,会一直监听注册表内设备的增加和删除,所以显示的设备列表会实时更新。 
  57.  
  58. 以下是activity类的骨架: 
  59.  
  60. ``` 
  61. import android.app.ListActivity; 
  62. import android.content.ComponentName; 
  63. import android.content.Context; 
  64. import android.content.Intent; 
  65. import android.content.ServiceConnection; 
  66. import android.os.Bundle; 
  67. import android.os.IBinder; 
  68. import android.view.Menu; 
  69. import android.view.MenuItem; 
  70. import android.widget.ArrayAdapter; 
  71. import android.widget.Toast; 
  72. import org.teleal.cling.android.AndroidUpnpService; 
  73. import org.teleal.cling.android.AndroidUpnpServiceImpl; 
  74. import org.teleal.cling.model.meta.Device; 
  75. import org.teleal.cling.model.meta.LocalDevice; 
  76. import org.teleal.cling.model.meta.RemoteDevice; 
  77. import org.teleal.cling.registry.DefaultRegistryListener; 
  78. import org.teleal.cling.registry.Registry; 
  79.  
  80. public class UpnpBrowser extends ListActivity { 
  81.  
  82.     private ArrayAdapter<DeviceDisplay> listAdapter; 
  83.  
  84.     private AndroidUpnpService upnpService; 
  85.  
  86.     private ServiceConnection serviceConnection = ... 
  87.  
  88.     private RegistryListener registryListener = new BrowseRegistryListener(); 
  89.  
  90.     @Override 
  91.     public void onCreate(Bundle savedInstanceState) { 
  92.         super.onCreate(savedInstanceState); 
  93.  
  94.         listAdapter = 
  95.             new ArrayAdapter( 
  96.                 this, 
  97.                 android.R.layout.simple_list_item_1 
  98.             ); 
  99.         setListAdapter(listAdapter); 
  100.  
  101.         getApplicationContext().bindService( 
  102.             new Intent(this, AndroidUpnpServiceImpl.class), 
  103.             serviceConnection, 
  104.             Context.BIND_AUTO_CREATE 
  105.         ); 
  106.     } 
  107.  
  108.     @Override 
  109.     protected void onDestroy() { 
  110.         super.onDestroy(); 
  111.         if (upnpService != null) { 
  112.             upnpService.getRegistry().removeListener(registryListener); 
  113.         } 
  114.         getApplicationContext().unbindService(serviceConnection); 
  115.     } 
  116.  
  117.     ... 
  118.  
  119. } 
  120. ``` 
  121.  
  122. 我们采用Android运行时默认提供的布局和ListActivity父类。注意这个类可以是你应用的主activity,或者进一步上升进任务的堆栈。listAdapter黏合了Cling Registry上设备的增加移除事件与展示在用户界面的列表项目。 
  123.  
  124. 当没有后台服务绑定到该activity时,upnpService变量为null。绑定和解绑发生在onCreate()和onDestroy()回调,所以activity绑定服务和它的生存周期一样长。 
  125.  
  126. ``` 
  127. 暂停后台的UPnP服务 
  128. 当一个activity不再活动时(停止或暂停状态),它仍会绑定着UPnP服务。UPnP服务将会持续运行,即使应用不再可见。由于UPnP服务的注册表一定会定期维护发现的设备、刷新本地设备的通告、删除过期的GENA事件订阅等,将会消耗你设备的CPU和电量。当activity onPause()或onStop()方法被调用时,你可以调用Registry#pause()来通知UPnP服务不再维护注册表。之后,你可以通过Registry#resume()来恢复后台服务,或同时用Registry#isPaused()检查状态。请阅读这些方法的Javadoc了解详细信息,以及暂停注册表维护对于设备、服务和GENA订阅的意义。 
  129. ``` 
  130.  
  131. 以下是使用ServiceConnection处理绑定和解绑服务: 
  132.  
  133. ``` 
  134. private ServiceConnection serviceConnection = new ServiceConnection() { 
  135.  
  136.     public void onServiceConnected(ComponentName className, IBinder service) { 
  137.         upnpService = (AndroidUpnpService) service; 
  138.  
  139.         // Refresh the list with all known devices 
  140.         listAdapter.clear(); 
  141.         for (Device device : upnpService.getRegistry().getDevices()) { 
  142.             registryListener.deviceAdded(device); 
  143.         } 
  144.  
  145.         // Getting ready for future device advertisements 
  146.         upnpService.getRegistry().addListener(registryListener); 
  147.  
  148.         // Search asynchronously for all devices 
  149.         upnpService.getControlPoint().search(); 
  150.     } 
  151.  
  152.     public void onServiceDisconnected(ComponentName className) { 
  153.         upnpService = null; 
  154.     } 
  155. }; 
  156. ``` 
  157.  
  158. 首先,所有已知的UPnP设备能够被查询和显示(如果UPnP服务刚开启且到到目前还没有设备通告它的存在)。 
  159.  
  160. 然后,给UPnP服务的注册表增加一个监听者。该监听者将会处理在你网络上发现的设备的增加和移除,并在更新在用户界面列表内显示的项目。当activity销毁时,BrowseRegistryListener会被移除。 
  161.  
  162. 最后,通过发送一个搜寻消息给所有UPnP设备,你会开启异步搜索,此时这些设备将通告它们的存在。注意这个搜寻消息不是每次连接服务都需要的。这只需一次,在当主activity和应用启动时,其会将已知设备写入注册表。 
  163.  
  164. 以下是BrowseRegistryListener,他的任务就是更新列表项的显示: 
  165.  
  166. ``` 
  167. class BrowseRegistryListener extends DefaultRegistryListener { 
  168.  
  169.     @Override 
  170.     public void remoteDeviceDiscoveryStarted(Registry registry, RemoteDevice device) { 
  171.         deviceAdded(device); 
  172.     } 
  173.  
  174.     @Override 
  175.     public void remoteDeviceDiscoveryFailed(Registry registry, final RemoteDevice device, final Exception ex) { 
  176.         runOnUiThread(new Runnable() { 
  177.             public void run() { 
  178.                 Toast.makeText( 
  179.                         BrowseActivity.this, 
  180.                         "Discovery failed of '" + device.getDisplayString() + "': " + 
  181.                                 (ex != null ? ex.toString() : "Couldn't retrieve device/service descriptors"), 
  182.                         Toast.LENGTH_LONG 
  183.                 ).show(); 
  184.             } 
  185.         }); 
  186.         deviceRemoved(device); 
  187.     } 
  188.  
  189.     @Override 
  190.     public void remoteDeviceAdded(Registry registry, RemoteDevice device) { 
  191.         deviceAdded(device); 
  192.     } 
  193.  
  194.     @Override 
  195.     public void remoteDeviceRemoved(Registry registry, RemoteDevice device) { 
  196.         deviceRemoved(device); 
  197.     } 
  198.  
  199.     @Override 
  200.     public void localDeviceAdded(Registry registry, LocalDevice device) { 
  201.         deviceAdded(device); 
  202.     } 
  203.  
  204.     @Override 
  205.     public void localDeviceRemoved(Registry registry, LocalDevice device) { 
  206.         deviceRemoved(device); 
  207.     } 
  208.  
  209.     public void deviceAdded(final Device device) { 
  210.         runOnUiThread(new Runnable() { 
  211.             public void run() { 
  212.                 DeviceDisplay d = new DeviceDisplay(device); 
  213.                 int position = listAdapter.getPosition(d); 
  214.                 if (position >= 0) { 
  215.                     // Device already in the list, re-set new value at same position 
  216.                     listAdapter.remove(d); 
  217.                     listAdapter.insert(d, position); 
  218.                 } else { 
  219.                     listAdapter.add(d); 
  220.                 } 
  221.             } 
  222.         }); 
  223.     } 
  224.  
  225.     public void deviceRemoved(final Device device) { 
  226.         runOnUiThread(new Runnable() { 
  227.             public void run() { 
  228.                 listAdapter.remove(new DeviceDisplay(device)); 
  229.             } 
  230.         }); 
  231.     } 
  232. } 
  233. ``` 
  234.  
  235. 鉴于性能的原因,当发现设备时,我们会直到一个完整的hydrated(所有设备被检索和验证)设备元数据模型可用时才执行等待。我们响应尽可能得快,同时只当remoteDeviceAdded()方法被调用时才去等待。甚至当搜索仍在运行时,我们仍旧显示所有设备。在台式电脑上你通常不需要关心这个,不过,Android手持设备效率慢,并且UPnP使用好些臃肿的XML描述符来交换关于设备和服务的元数据。有时,在设备和它的服务完全可用前,这可能会花费数秒钟。而remoteDeviceDiscoveryStarted()和remoteDeviceDiscoveryFailed()方法在搜索处理时会尽快被调用。顺便说一句,如果设备有相同的UDN就表示相等的(a.equal(b)),但它们可能不会完全一致(a==b)。 
  236.  
  237. 注意注册表将会在分开的线程中调用监听者方法。你必须在UI线程中更新显示列表数据。 
  238.  
  239. activity中以下两个方法增加了用来搜寻的菜单,如此用户才能手动的刷新列表: 
  240.  
  241. ``` 
  242. @Override 
  243. public boolean onCreateOptionsMenu(Menu menu) { 
  244.     menu.add(0, 0, 0, R.string.search_lan) 
  245.         .setIcon(android.R.drawable.ic_menu_search); 
  246.     return true; 
  247. } 
  248.  
  249. @Override 
  250. public boolean onOptionsItemSelected(MenuItem item) { 
  251.     if (item.getItemId() == 0 && upnpService != null) { 
  252.         upnpService.getRegistry().removeAllRemoteDevices(); 
  253.         upnpService.getControlPoint().search(); 
  254.     } 
  255.     return false; 
  256. } 
  257. ``` 
  258.  
  259. 最后,DeviceDisplay类是一个非常简单的JavaBean,只提供一个toString()方法来呈现列表信息。通过修改此方法,你能够显示任何关于UPnP设备的信息: 
  260.  
  261. ``` 
  262. class DeviceDisplay { 
  263.     Device device; 
  264.  
  265.     public DeviceDisplay(Device device) { 
  266.         this.device = device; 
  267.     } 
  268.  
  269.     public Device getDevice() { 
  270.         return device; 
  271.     } 
  272.  
  273.     @Override 
  274.     public boolean equals(Object o) { 
  275.         if (this == o) return true; 
  276.         if (o == null || getClass() != o.getClass()) return false; 
  277.         DeviceDisplay that = (DeviceDisplay) o; 
  278.         return device.equals(that.device); 
  279.     } 
  280.  
  281.     @Override 
  282.     public int hashCode() { 
  283.         return device.hashCode(); 
  284.     } 
  285.  
  286.     @Override 
  287.     public String toString() { 
  288.         // Display a little star while the device is being loaded 
  289.         return device.isFullyHydrated() ? device.getDisplayString() : device.getDisplayString() + " *"; 
  290.     } 
  291. } 
  292. ``` 
  293.  
  294. 还有我们必须覆盖相等操作,这样我们才可以用DeviceDisplay实例作为便捷的处理,从列表中手动地移除和增加设备。 
  295.  
  296. ### 5.3. 优化服务行为 
  297. UPnP服务运行时会消耗内存和CPU。尽管通常在一个正常的机器上没有什么问题,但在Android手持设备上就可能会有了。如果你禁用Cling UPnP服务的某些功能,或者设置暂停且在合适时恢复它,你可以留有更多的内存和电量。 
  298.  
  299. #### 5.3.1. 调整注册表维护 
  300. 当服务运行时,后台有好些东西在执行。首先,有一个服务的注册表和其维护线程。如果你写一个控制端,后台注册表维护者将会定期从远程服务更新你对外的GENA订阅。当没有通知断开网络时,它也会到期并移除任何远程服务。如果你正提供服务,你的设备通告将被注册表维护者刷新,并在GENA订阅没及时更新时移除它。注册表维护者为了有效得防止UPnP网络上的过时状态,所以所有参与者会实时更新其他参与者的视图等等。 
  301.  
  302. 默认情况下,注册表维护者会每秒运行并检查是否有事要做(当然,大多数情况下没事做)。然而默认的Android配置有5秒的间隔休眠,所以这已经花费了更少的后台CPU占用时间 — 不过你的应用可能会暴露稍微过时的信息。在UpnpServiceConfiguration你可以通过覆盖getRegistryMaintenanceIntervalMillis()进一步的调整设置。在Android上,你必须子类化服务实现来提供一个新的配置。 
  303.  
  304. ``` 
  305. public class MyUpnpService extends AndroidUpnpServiceImpl { 
  306.  
  307.     @Override 
  308.     protected AndroidUpnpServiceConfiguration createConfiguration(WifiManager wifiManager) { 
  309.         return new AndroidUpnpServiceConfiguration(wifiManager) { 
  310.  
  311.             @Override 
  312.             public int getRegistryMaintenanceIntervalMillis() { 
  313.                 return 7000; 
  314.             } 
  315.  
  316.         }; 
  317.     } 
  318. } 
  319. ``` 
  320.  
  321. 此时不要忘了在AndroidManifest.xml内配置MyUpnpService,而不是原先的实现。当在你的activities里绑定服务时,也必须使用该类型。 
  322.  
  323. #### 5.3.2. 暂停和恢复注册表维护 
  324. 另外一个更有效同时也不是很复杂的优化是,每当你的activites不再需要UPnP服务时,暂停和恢复注册表。这通常发生在当activity不在前台(暂停),甚至不再显示(停止)时。默认情况下,activity状态改变对UPnP服务没有影响,除非你在activities生命周期的回调内绑定和解绑服务。 
  325.  
  326. 除了绑定和解绑服务,你也可以在activity onPause()或onStop()方法被调用时,通过调用Registry#pause()来暂停注册表。之后,你可以通过Registry#resume()来恢复后台服务,或同时用Registry#isPaused()检查状态。 
  327.  
  328. 请阅读这些方法的Javadoc了解详细信息,以及暂停注册表维护对于设备、服务和GENA订阅的意义。根据你的应用要做什么,否则这种小的优化可能不值得处理这些效果。另一方面,你的应用应当能够处理失败的GENA订阅续期,或者消失的远程设备。 
  329.  
  330. #### 5.3.3. 配置搜索 
  331. 最有效的优化是UPnP设备有选择性的搜索。尽管UPnP服务的网络传输层在后台会保持运行(线程正等待且socket被绑定),这个特性允许你有选择且快速的丢弃搜索信息。 
  332.  
  333. 举例来说,如果你正在写一个控制端,且不通告你想要控制的服务(对其他设备没兴趣),那么你可以丢弃所有接收的搜索信息。另一方面,如果你只提供设备和服务,所有搜索信息(除了你自身服务的搜索信息)可能都可以被丢弃,你对其他远程设备和其服务一点都不会有兴趣。 
  334.  
  335. 一旦UDP数据包内容可用,该搜索信息就会被Cling选择并偷偷的丢弃,所以不需要进一步得解析和处理,同时CPU时间和内存消耗显著得减少,即使当你在Android手持设备上后台持续运行UPnP服务。 
  336.  
  337. 为了配置你的控制端应用支持哪些服务,需要覆盖前面章节展示的服务接口并提供一组ServiceType实例: 
  338.  
  339. ``` 
  340. public class MyUpnpService extends AndroidUpnpServiceImpl { 
  341.  
  342.     @Override 
  343.     protected AndroidUpnpServiceConfiguration createConfiguration(WifiManager wifiManager) { 
  344.         return new AndroidUpnpServiceConfiguration(wifiManager) { 
  345.  
  346.             @Override 
  347.             public ServiceType[] getExclusiveServiceTypes() { 
  348.                 return new ServiceType[] { 
  349.                         new UDAServiceType("SwitchPower") 
  350.                 }; 
  351.             } 
  352.  
  353.         }; 
  354.     } 
  355. } 
  356. ``` 
  357.  
  358. 这个配置将会忽略所有不通告chemas-upnp-org:SwitchPower:1的任何通告。这是我们控制端要处理的,不需要其他任何东西了。如果你返回一个空的数组(默认行为),所有服务和设备将会发现以及没有通告会被丢弃。 
  359.  
  360. 如果你正在写一个控制端应用而不是服务应用,你可以让getExclusiveServiceTypes()方法返回null。这将会完全禁用搜索,此时所有设备和服务的通告一接收就会被丢弃。 

 






     本文转自winorlose2000 51CTO博客,原文链接:http://blog.51cto.com/vaero/1143278,如需转载请自行联系原作者



相关文章
|
Ubuntu Linux
linux实用技巧:ubuntu16.04安装BeyondCompare文件/文件夹对比工具
linux实用技巧:ubuntu16.04安装BeyondCompare文件/文件夹对比工具
linux实用技巧:ubuntu16.04安装BeyondCompare文件/文件夹对比工具
|
Linux C语言 内存技术
Linux下使用alsa-lib库完成音频开发: 实现放音和录音(从声卡获取PCM数据保存、向声卡写PCM数据输出)
Linux下使用alsa-lib库完成音频开发: 实现放音和录音(从声卡获取PCM数据保存、向声卡写PCM数据输出)
2282 0
|
7月前
|
人工智能 自然语言处理 安全
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
本文介绍了Claude Code终端AI助手的使用指南,主要内容包括:1)常用命令如版本查看、项目启动和更新;2)三种工作模式切换及界面说明;3)核心功能指令速查表,包含初始化、压缩对话、清除历史等操作;4)详细解析了/init、/help、/clear、/compact、/memory等关键命令的使用场景和语法。文章通过丰富的界面截图和场景示例,帮助开发者快速掌握如何通过命令行和交互界面高效使用Claude Code进行项目开发,特别强调了CLAUDE.md文件作为项目知识库的核心作用。
52457 73
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
|
Windows
系统重装PE工具下载,没有广告,没有劫持,AMpe 工具箱,Edgeless+Hub,ventoy,Finpe
本文推荐多款实用PE工具箱,如AMpe、Ventoy、FirPE、Edgeless+Hub,涵盖系统重装、上网维护等需求,界面美观、操作简便,并提供纯净系统镜像下载站及使用建议,助力高效装机。
3007 0
|
JavaScript 前端开发 安全
Vue 3 + TypeScript 现代前端开发最佳实践(2025版指南)
每日激励:“如果没有天赋,那就一直重复”。我是蒋星熠Jaxonic,一名执着于代码宇宙的星际旅人。用Vue 3与TypeScript构建高效、可维护的前端系统,分享Composition API、状态管理、性能优化等实战经验,助力技术进阶。
1459 1
Vue 3 + TypeScript 现代前端开发最佳实践(2025版指南)
|
编解码 开发工具 Android开发
技术心得:打造自己的智能投屏体验——Android投屏开发入门
技术心得:打造自己的智能投屏体验——Android投屏开发入门
3955 0
|
存储 数据处理 对象存储
云端问道方案教学4期—多媒体数据存储与分发
本文整理自阿里云存储服务产品团队关于多媒体数据存储与分发的分享,涵盖以下四部分内容:1)行业痛点及背景:分析Web 2.0到AIGC时代下多媒体行业的存储挑战;2)方案优势介绍:结合对象存储(OSS)、智能媒体管理(IMM)和内容分发网络(CDN),提供高效、低成本的解决方案;3)典型场景应用:包括音视频、在线教育、网站/APP/小程序、游戏下载等场景的具体应用;4)选型推荐:根据业务需求选择合适的产品配置。该方案通过动静分离、智能处理和全球加速,帮助企业在数据存储与分发中实现降本增效。
679 2
|
Java Android开发
MAT如何使用?
MAT如何使用?
1834 4
|
安全 物联网 Unix
什么是安全操作系统?
什么是安全操作系统?
969 2
|
Java Shell
Gradle的安装及换源
Gradle的安装及换源
9213 1