Platinum UPnP SDK 是一个跨平台的C++库,利用该库,可以很容易就构建出DLNA/UPnP控制点(DLNA/UPnP Control Point)和DLNA/UPnP设备(DLNA/UPnP Device),其中包括有UPnP AV Media Server, Media Render & Control Point的例子。它可以在Windows, Mac OSX, Linux, iPhone, Android, Symbian等多种C语言开发平台上编译通过且运行
官方网址:http://www.plutinosoft.com/platinum
SDK下载地址:http://sourceforge.net/projects/platinum/
下载后得到一个PlatinumKit-1-0-4-2_99100e_aab601.zip
版本信息为
Platinum Kit Version 1-0-4-2
-----------------------------
Neptune: aab601
Platinum: 99100e
解压开来先熟悉下该包的内容
查看Platinum目录下的ReadMe.txt
该包包含了这两个主要的库
进入Platinum\Build\Targets\x86-microsoft-win32-vs2008目录
打开PlatinumManaged.sln解决方案可以看到工程的关联
Neptune和Platinum都是静态链接库,后续编译so库会用到
Platinum.Managed是动态链接库,暂时不用管
看看给android调用的so库如何编译
首先要下载ndk组件包
网址:http://developer.android.com/tools/sdk/ndk/index.html#Installing
这里我以ubuntun 64位环境为例,下载android-ndk-r8e-linux-x86_64.tar.bz2
在ubuntun下解压后配置ANDROID_NDK_ROOT环境变量
<1>使用命令vi ~/.bashrc 打开环境变量设置,并在文件末尾添加:
ANDROID_NDK_ROOT=你的ndk根目录绝对路径
export ANDROID_NDK_ROOT
<2>使用命令source ~/.bashrc使环境变量设置生效。
<3>使用命令echo $ANDROID_NDK_ROOT查看是否生效,如果输出完整路径正确,说明环境变量设置ok.
<4>此步可选,使用cd命令进入到androidNDK/samples/hello-jni进入例子目录,然后使用命令:sudo $ANDROID_NDK_ROOT/ndk-build如果编译成功,则会生成so库,表示NDK能够正常Work了
Ndk环境搭好后就可以编译Platinum lib了
<1>在androidNDK目录下面生成out/config.mk文件,里面输入内容如下:
HOST_TAG:=linux-x86
然后保存退出;
<2>进入Platinum目录
打命令scons target=arm-android-linux build_config=Release
(请确保scons工具已安装)
正常的话最后会输出:scons: done building targets.表示编译完成了。
在Platinum\Build\Targets\arm-android-linux\Release目录下生成相关*.a库
不带后缀的是c可执行文件
<3>进入到/PlatinumKit/Platinum/Source/Platform/Android/module/platinum/jni目录下面,
注意:这里需要先修改该jni目录下的Android.mk文件,将LOCAL_LDLIBS += -laxTls改为LOCAL_LDLIBS += -laxTLS,主要是前面生成库的名字是-laxTLS而不是-laxTls
使用命令:$ANDROID_NDK_ROOT/ndk-build NDK_DEBUG=0
编译之后会输出如下信息,表示生成SO库成功。
SharedLibrary : libplatinum-jni.so
Install : libplatinum-jni.so => libs/armeabi/libplatinum-jni.so
进入到目录PlatinumKit/Platinum/Source/Platform/Android/module/platinum/lib目录下面可以看到生成so库.
最后是测试该so库
将Platinum\Source\Platform\Android下的两个工厂导入eclipse
一个是lib工程,一个是apk工程,建立引用关系,然后在platinum工程下建立libs/armeabi目录并将前面编好的so库放进去
运行sample-upnp
示例比较粗糙,start后设备并不能被外界发现,需要自己重新封装,具体用法可参照
Platinum\Source\Tests\MediaRenderer下的MediaRendererTest.cpp文件
可在PlatinumManaged.sln解决方案下将MediaRendererTest工程导入,然后配置项目依赖项把那两个静态库添进来,在window下将MediaRendererTest跑起来可被外界发现
至此一个简单的platinum的so库封装和调用就实现了
至于DMR,DMS以及DMC等实现就需要自己先摸透该框架的使用方法
主要涉及到这三个类
PLT_FileMediaServer:封装实现了DMS
PLT_MicroMediaController:不是库里的类,是其一个例子的类,继承了PLT_SyncMediaBrowser和PLT_MediaController,即实现了DMC
PLT_MediaRenderer:实现了DMR
另外里面许多示例程序包括Platinum.Managed都是值得参考借鉴的
好了Platinum UPnP SDK的初级使用教程到此结束
关于DMR和DMS的实现请参考这两篇博文: