Android 接收端 SDK 集成
一 跟目录的build.gradle添加私有mevan仓库
maven {url 'http://nexus.dolphinstar.cn/repo/openmavenx'}
二 app/build.gradle
2.1 添加依赖
implementation 'cn.dolphinstar:playerCore:3.1.36' // 最新版本请在后台查看
2.2 开启JAVA8支持
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
三 权限
<!-- 网络访问全系 必须权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--屏幕保持唤醒 不锁屏-->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!--允许程序访问Wi-Fi网络状态信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--添加读写外部存储权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!--蓝牙设备-->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
四 网络
注意 android 9后强制https,为了支持http。应在AndroidManifest.xml的Application节点添加
android:networkSecurityConfig="@xml/network_security_config"
network_security_config.xml
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true" />
</network-security-config>
五 申请AppId
前往 海豚星空平台 控制中心 注册并创建应用获取appId
在app/src/main/assets
添加文件dpsAppInfo
添加建值对
APPID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
(注意: SDK v 4.0.0 后支持 StartUpCfg.AppId传入参数,将覆盖配置设置)
六 启动服务
//启动配置
StartUpCfg cfg = new StartUpCfg();
/*
应用的Secret
必须
*/
cfg.AppSecret = "";
/*
如果PlayerName为空
SDK v4.0.0之后版本将显示后台配置的"别名-xxx",如果没有设置别名将显示为"海豚星空TV-xxx"
可以在投屏服务启动成功后通过MYOUPlayer.of(MainActivity.this).getMediaRenderName()获取
*/
cfg.PlayerName = "海豚星空TV-" +(int) (Math.random() * 900 + 100);
/*
应用APPID
可选
优先级大于配置文件dpsAppInfo里的配置
*/
cfg.AppId = "";
/*
使用网卡名称
可选
多网卡同时联网指定投屏使用指定网卡的IP,
如果指定,必须得有网络,否则ip为NULL
不指定自动获取任意可用IP
*/
cfg.useNetwork = "wlan0";
//启动服务
MYOUPlayer.of(MainActivity.this)
.StartService(cfg)
.subscribe(s -> {
//投屏服务启动成功
Log.e("MainActivity","投屏服务启动成功");
}, e -> {
//投屏服务启动失败
Log.e("MainActivity","投屏服务启动失败:"+ e.getMessage());
});
完成!!!
附录
多网卡指定获取授权 MAC 地址
在 app/src/main/assets/dpsAppInfo 添加配置
AUTHMACTYPE=eth0
# eth0 使用有线网络 MAC
# wlan 使用无线网卡 MAC