UPNP 功能的实现
UPNP 媒体播放器作为一个 UPNP 家庭网络中的媒体播放器,还可对网络中的多媒体文
件进行播放的功能,同时它也是一个 UPNP 设备,应该支持 UPNP 规定的一些功能,包括设
备发现,设备描述,设备控制等功能。
- 初始化整个 UPNP 协议栈
在 UPNP 媒体播放器中的播放页面 PlayerActivity 中完成 UPNP 协议栈的初始化,通过调
用 cling 开发库中的 AndroidUpnpService 接口来实现
public interface AndroidUpnpService {
public UpnpService get();
public UpnpServiceConfiguration getConfiguration();
public Registry getRegistry();
public ControlPoint getControlPoint();
}
- 设备注册和初始化
在设备注册前,应先创建一个 UPNP 设备,用 createDevice()函数完成对设备的初始化,
注册设备描述文档。其中设备描述包括设备的名称,类型、详细信息等。
protected LocalDevice createDevice()
{
DeviceType type = new UDADeviceType("UpnpPlayer", 1); //设备名称
DeviceDetailsdetails=newDeviceDetails("UpnpPlayeron"
ModelUtil.getLocalHostName(false), //设备详细信息
New ManufacturerDetails("UpnpPlayer", "http://www.njupt.edu.cn")); //设备制造商
DeviceIdentity identity = new DeviceIdentity(udn);
return new LocalDevice( identity, type, details,createService());
}
- 在 UPNP 设备中添加所需的 UPNP 服务
本项目中所实现的媒体播放器包含的服务有:
连接管理服务和内容传输服务。其中连接管理服务主要用来管理与媒体服务器之间的连接。
public LocalService<?>[] createService()
{
LocalService<?> Service_Connect = localServiceConnect(); //连接管理服务
LocalService<?> Service_Transport = localServiceAvtransport(); //内容传输服务
LocalService<?> [] localService ={ Service_Connect ,Service_Transport };
return localService;
}
当设备和服务都创建好之后,就需要将此设备添加到注册表中以便能够将此设备信息及服
务信息发布到 UPNP 网络中。需要调用 Cling 开发库中的 addDevice()方法:
upnpService.getRegistry().addDevice(UpnpPlayerDevice);
其中 UpnpPlayerDevice 为创建好的媒体播放器设备。
4. 控制点发送命令,媒体播放器接收处理
根据媒体播放器的工作流程可知,当控制点选择好媒体播放器上的多媒体文件后,需要
将媒体文件的 URL 发送给媒体播放器,这时会触发设置媒体播放器的传输地址这一动作,则
会调用内容传输服务中的 SetAVTransportURI()给媒体播放器提供多媒体文件的 URL。
获得 URL 后,调用内容传输服务中的 play()接口开始媒体内容传输动作。
当控制点在网络多媒体服务器上定位了一个多媒体文件时,再通过选择对应的多媒体播
放器则会触发设置传输地址这个动作。在本设计中调用 propertyChange 这个方法去实现。
public void propertyChange(PropertyChangeEvent event)
{
if (event.getPropertyName().equals("AVTransportURI"))
{
log.info("Turning light: " + event.getNewValue());
playVideo((String) event.getNewValue());
}
}