Skip to content

Latest commit

 

History

History
137 lines (115 loc) · 5.97 KB

README.md

File metadata and controls

137 lines (115 loc) · 5.97 KB
Raw

ClingLib

功能：Android DLNA投屏

建议使用这位devin1014的DLNA-Cast

已实现

  1. 基础投屏功能
  2. 本地资源投屏

本项目主要是为自己的业务实现的，如果有需要请自行修改，不提供解决方案

注意事项

allprojects {
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            /.../
            maven { url "https://jitpack.io" }
            maven {
                url 'http://4thline.org/m2'
                allowInsecureProtocol = true  //当前maven支持http
            }
        }
    }
}

主module需要加入

   packagingOptions {
    exclude 'META-INF/beans.xml'
}

遇到的问题：

  • 设备搜索问题：cling 2.1.2 搜索设备有问题，暂时不要用，用2.1.1
  • 集成过程中：可能存在slf4j-simple重复： exclude group: 'org.slf4j', module: 'slf4j-simple'
  • 投屏成功没有播放：【有些电视不会自动播放】：调用setAVTransportURI投屏后还要调用掉一次play才能播放
  • 构建本地服务器只能是http: 需要修改network_security_config.xml中的<base-config cleartextTrafficPermitted="true">
  • 暂时不支持Referer，项目有代码尝试，但是没有测试，暂时没有条件测试，如果有需要，可以自行测试,然后告诉我结论
  • 创建本地服务端口被占用，已经try住，会自动加一重新创建，最多重复10次，如果还是不行，就会创建本地服务失败
  • 有使用者，视频太大导致播放失败，可以删除LocalFileService中设置setContentLength的对应行，因为cling自带的jetty版本太低，不支持setContentLengthLong

使用方法

1. 启动服务

mUpnpServiceConnection = startBindUpnpService()

2. 停止服务

stopUpnpService(mUpnpServiceConnection)

3. 搜索设备

ClingDLNAManager.getInstant().searchDevices()  //默认启动服务后会自动搜索一次
ClingDLNAManager.getInstant().getCurSearchDevices().observe(this) {
    mAdapter.setList(it)  //展示搜索结果
}

4. 投屏相关

control = ClingDLNAManager.getInstant().connectDevice(device)
control.setAVTransportURI(uri , title,type, callback)
control.setNextAVTransportURI(uri, title, callback)
control.play(speed = "1", callback)
control.pause(callback)
control.stop(callback)
control.seek(millSeconds, callback)
control.next(callback)
control.canNext(callback) 
control.previous(callback)
control.canPrevious(callback) 
control.getPositionInfo(callback)
control.getMediaInfo(callback)
control.getTransportInfo(callback)

5. 本地资源投屏，投屏期间不可关闭服务【请自行选择是否开启多进程服务】

原理：

  1. 利用jetty和servlet-api构建手机本地的服务器，又因为DLNA投屏需要手机和电视在同一个局域网中，所以电视是可以访问到的手机的资源【App要具有对应的权限】。因此投屏期间不可关闭服务，否则会导致播放失败.
  2. 构建本地服务器只能是http: 需要修改network_security_config.xml中的<base-config cleartextTrafficPermitted="true">
  3. 本地服务的contentType = "application/octet-stream"，是一个通用的 MIME 类型，表示二进制数据流。所以有些辣鸡的播放器可能无法识别，不过你可以增加更多的判断进行设置contentType。【重写LocalFileService】
    • 通过传入路径的文件结尾来判断contentType，如果没有找到，就使用默认的application/octet-stream，如果你有更好的方法，欢迎提出来
        put("png", "image/png")
        put("jpg", "image/jpeg")
        put("mp4", "video/mp4")
        put("mov", "video/quicktime")
        put("wmv", "video/x-ms-wmv")
        put("m3u8", "application/x-mpegURL")
        put("mp3","audio/mpeg")
        put("m4a","audio/m4a")
        put("wav","audio/wav")
        put("aac","audio/aac")
5.1 启动本地服务器
    ClingDLNAManager.startLocalFileService(this)
5.2 选择文件构建本地url【注意权限的获取】
val url = ClingDLNAManager.getBaseUrl(this) + 本地路径
5.3 关闭服务
   ClingDLNAManager.stopLocalFileService(this)
  • 案例如下:MainActivity.kt
  • 如果没有wifi: 会是 127.0.0.1，所以请在连接好wifi和设备后，在构建本地的url，防止构建出错误的url,导致无法播放，同时播放中请不要关闭本地的服务器的Service
  • 链接组成 : http://xxx.xx.xx.xx:5050/clingLocaleFile//data/user/0/com.shetj.clinglib/cache/1000022406.mp4
    • 其中xxx.xx.xx.xx是手机链接wifi后的ip地址
    • 5050是端口号
    • clingLocaleFile是固定的，重写LocalFileService可以修改
    • /data/user/0/com.xxx.xxx/xxx/1000022406.mp4是本地的路径，也可以自己结合LocalFileService重新定义,这样就可以不用担心暴露本地路径了

友情提示

  • 当前项目本人已应用到项目，虽然有些地方有修改，但是基础功能都是一样的，并且可以正常使用。所以有问题，请优先自己先调试一下，找找问题，解决不了，在提提问会比较好
  • 不建议直接使用，可以先去学习理解其中的原理：DLNA、UPnP、本地服务器等等，然后下载下来在按自己的业务进行调整修改
  • 这个Lib是因为乐播收费才做的需求，目前已经满足自己的业务需求，后续不会再更新，直到有新的需求~ 有些地方可能不是很完善，如果有需要，可以自行修改，如果有问题，请优先自己先调试一下，找找问题，解决不了，在提提问会比较好，我会尽量解决