下面就以 Android 平台创建 UPnP 服务并调用相关的控制方法介绍 Cling 的基本使用。
(1) 定义自己的 UpnpService 类,继承自 AndroidUpnpServiceImpl
(2) 启动该 Service
(3) 从 UpnpService 中获取 ControlPoint,并搜索设备
upnpService.getControlPoint().search(new STAllHeader());
搜索注册在多播地址的所有设备,也可根据需要使用不同条件搜索。
(4) 获取所有类型为 MediaRenderer 的设备
upnpService.getRegistry().getDevices(new UDADeviceType("MediaRenderer"));
(5) 向 Device 发送指令
从查找到的结果中获取一个 Device,并向其发送 Play 指令
Device device = SystemManager.getInstance().getSelectedDevice();
if (device == null) {
return;
}
Service avtService = device.findService(new UDAServiceType("AVTransport"));
if (avtService != null) {
ControlPoint cp = SystemManager.getInstance().getControlPoint();
cp.execute(new Play(avtService) {
@Override
public void success(ActionInvocation invocation) {
Log.i(TAG, "Play success.");
}
@Override
public void failure(ActionInvocation arg0, UpnpResponse arg1, String arg2) {
Log.e(TAG, "Play failed");
}
});
}
上述即为一个基本的发现、控制流程,通过 ControlPoint 发送指令并处理 callback。