Skip to content

Latest commit

 

History

History
162 lines (131 loc) · 4.96 KB

README_v1.md

File metadata and controls

162 lines (131 loc) · 4.96 KB
Raw

DLNA-Cast

Author: LIUWEI
Email: [email protected]

Download

有时间会更新这个库，好多人在问Dmr的问题，我这个只是最简单的一个VideoView示例，具体还是需要自己集成播放器，实现各种格式的流。 另外我也在做DLNA的Flutter库，差不多了也会开源出来。

功能

基于Cling库封装的DLNA投屏库

  • 支持移动端设备控制（DMC）功能
  • 支持投射本地视频（DMS）或者网络视频
  • 支持电视端设备播放器功能（DMR）

Cling库(v2.1.1)

Cling Core Cling Support

#App示例

AppScreenshot

使用说明

引用地址

在项目根gradle中引入

allprojects {
	repositories {
		...
        maven { url 'http://4thline.org/m2' }
		maven { url 'https://jitpack.io' }
	}
}

在项目模块gradle中引入

api 'com.github.devin1014.DLNA-Cast:dlna-dmc:V1.0.0'

权限申明

在AndroidManifest.xml中需要添加如下

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>

服务申明

在AndroidManifest.xml中需要添加如下

<service android:name="com.android.cast.dlna.dmc.DLNACastService"/>

注册服务

在Activity或者Fragment中绑定/解绑

@Override
protected void onStart() {        
    DLNACastManager.getInstance().bindCastService(this);
}

@Override
protected void onStop() {
    DLNACastManager.getInstance().unbindCastService(this);
}

当绑定服务后，会自动搜索设备，也可以手动搜索。

DLNACastManager.getInstance().search(null, 60);
  • type：需要搜索设备的类型，null表示不限制类型
  • maxSeconds：搜索最大搜索时长（单位：秒）

监听设备

DLNACastManager.getInstance().registerDeviceListener(listener);
DLNACastManager.getInstance().unregisterListener(listener);

当发现新设备时需要添加到设备列表中用于显示。

  • OnDeviceRegistryListener 该接口回调始终在主线程线程被调用

投屏

DLNACastManager.getInstance().cast(device, castObject)
  • device：已发现的设备（这个设备需要是Renderer类型，支持播放器才能投屏）
  • castObject：实现了ICast接口的实现类（主要参数是投屏的url）

事件监听

控制器事件监听

DLNACastManager.getInstance().registerActionCallbacks(callbacks);
  • callbacks: 操作事件回调接口，主要有如下事件接口(投屏、播放、暂停、停止、快进) CastEventListener、PlayEventListener、PauseEventListener、StopEventListener、SeekToEventListener 以上接口都继承自IServiceAction.IServiceActionCallback
interface IServiceActionCallback<T> {
    void onSuccess(T result); //成功
    void onFailed(String errMsg); //失败
}

播放器事件监听 DLNACastManager.getInstance().registerSubscriptionListener(listener)

  • listener:监听播放器端状态改变（根据测试每个电视端实现不同效果也不同，有的发有的不发！）
interface ISubscriptionListener {
    void onSubscriptionTransportStateChanged(TransportState event);
}

控制

目前支持的控制事件如下

interface IControl {
    void cast(Device<?, ?, ?> device, ICast object);
    boolean isCasting(Device<?, ?, ?> device);
    boolean isCasting(Device<?, ?, ?> device, @Nullable String uri);
    void stop();
    void play();
    void pause();
    void seekTo(long position);
    void setVolume(int percent);
    void setMute(boolean mute);
    void setBrightness(int percent);
}

查询

 interface IGetInfo {
    void getMediaInfo(Device<?, ?, ?> device, ICastInterface.GetInfoListener<MediaInfo> listener);
    void getPositionInfo(Device<?, ?, ?> device, ICastInterface.GetInfoListener<PositionInfo> listener);
    void getTransportInfo(Device<?, ?, ?> device, ICastInterface.GetInfoListener<TransportInfo> listener);
    void getVolumeInfo(Device<?, ?, ?> device, ICastInterface.GetInfoListener<Integer> listener);
    void getContent(Device<?, ?, ?> device, ContentType contentType, ICastInterface.GetInfoListener<DIDLContent> listener);
}
  • getMediaInfo：获取媒体信息
  • getPositionInfo：获取视频播放位置
  • getTransportInfo：获取当前设备播放状态
  • getVolumeInfo：获取当前设备音量信息
  • getContent：获取当前设备提供的目录信息（当前设备是DMS）