安卓智能電視或者安卓盒子的控制應用,可跨屏遠程輸入、遠程遙控(代替遙控器)盒子、盒子應用及文件管理、HTTP/RTMP/MMS網路視頻直播、ED2K/種子文件的視頻文件邊下邊播 ...
一、APP項目介紹:
APP名稱:TVRemoteIME
功能說明:安卓智能電視或者安卓盒子的控制應用,可跨屏遠程輸入、遠程遙控(代替遙控器)盒子、盒子應用及文件管理、HTTP/RTMP/MMS網路視頻直播、ED2K/種子文件的視頻文件邊下邊播
項目地址:https://github.com/kingthy/TVRemoteIME
APK包下載:https://github.com/kingthy/TVRemoteIME/raw/master/released/IMEService-release.apk
二、APP控制端界面截圖
控制端不需要安裝任何APK應用,直接在同區域網的手機、電腦或者PAD的瀏覽器訪問操作
輸入遙控:
應用管理:
文件管理:
視頻直播:
三、APP核心功能介紹
1、IMEService:APP的主核心入口,繼承於InputMethodService,用於實現輸入服務,提供簡易的QWERT鍵盤UI,核心的遙控功能也是通過此服務來實現的。
2、RemoteServer: APP的Web API服務,通過NanoHTTPD實現Web服務,控制端的所有操作都是直接調用此服務下的WebAPI介面實現。
3、ijkplayer項目: 視頻播放器項目,通過封裝ijkplayer播放器實現,封閉實現了視頻源的解析及下載,支持HTTP/RTMP/MMS網路視頻直播、ED2K/種子文件的視頻文件邊下邊播
4、thunder項目: 第三方的下載服務,實現視頻源的下載服務
5、index.html與ime_core.js: 實現控制端的功能頁面及腳本代碼,所有控制端的操作都是通過此頁面和腳本實現。
四、WebAPI介面介紹
1、“/text” :文本輸入介面,用於實現跨屏輸入
代碼文件:InputRequestProcesser.java
參數:
text = 要輸入的文本,可以為任意數量的字元
調用示例:
POST /text
text=要輸入的文字
代碼實現:
Web服務接收到介面請求後通過DataReceiver的onTextReceived事件方法通知輸入法服務IMEService,輸入法服務通過commitText方法將遠程輸入的文本提交輸入到相應的輸入框。
private boolean commitText(String text){
InputConnection ic = getCurrentInputConnection();
boolean flag = false;
if (ic != null){
Log.d(TAG, "commitText:" + text);
if(text.length() > 1 && ic.beginBatchEdit()){
flag = ic.commitText(text, 1);
ic.endBatchEdit();
}else{
flag = ic.commitText(text, 1);
}
}
return flag;
}
2、“/key",“/keydown“,”/keyup“: 三個介面分別實現按鍵不同的輸入狀態:”按擊“,”按下“,”彈起“。 可用於實現按鍵操作,如遠程遙控功能。
代碼文件:InputRequestProcesser.java
參數:
code = 按鍵碼,對應於安卓KeyEvent里定義的按鍵碼,特殊定義的按鍵碼”cls“表示“清空文本“
調用示例:
POST /key code=cls
POST /keydown code=67
代碼實現:
Web服務接收到介面請求後通過DataReceiver的onKeyEventReceived事件方法通知輸入法服務IMEService,輸入法服務再根據按鍵碼及按鍵動作進行處理。
@Override
public void onKeyEventReceived(String keyCode, int keyAction) {
if(keyCode != null) {
if("cls".equalsIgnoreCase(keyCode)){
InputConnection ic = getCurrentInputConnection();
if(ic != null) {
ic.performContextMenuAction(android.R.id.selectAll);
ic.commitText("", 1);
}
}else {
final int kc = KeyEvent.keyCodeFromString(keyCode);
if(kc != KeyEvent.KEYCODE_UNKNOWN){
if(mInputView != null && KeyEventUtils.isKeyboardFocusEvent(kc) && mInputView.isShown()){
if(keyAction == KEY_ACTION_PRESSED || keyAction == KEY_ACTION_DOWN) {
handler.post(new Runnable() {
@Override
public void run() {
if (!handleKeyboardFocusEvent(kc)) {
sendKeyCode(kc);
}
}
});
}
}
else{
long eventTime = SystemClock.uptimeMillis();
InputConnection ic = getCurrentInputConnection();
switch (keyAction) {
case KEY_ACTION_PRESSED:
sendKeyCode(kc);
break;
case KEY_ACTION_DOWN:
if(ic != null) {
ic.sendKeyEvent(new KeyEvent(eventTime, eventTime,
KeyEvent.ACTION_DOWN, kc, 0, 0, KeyCharacterMap.VIRTUAL_KEYBOARD, 0,
KeyEvent.FLAG_SOFT_KEYBOARD | KeyEvent.FLAG_KEEP_TOUCH_MODE));
}
break;
case KEY_ACTION_UP:
if(ic != null) {
ic.sendKeyEvent(new KeyEvent(eventTime, eventTime,
KeyEvent.ACTION_UP, kc, 0, 0, KeyCharacterMap.VIRTUAL_KEYBOARD, 0,
KeyEvent.FLAG_SOFT_KEYBOARD | KeyEvent.FLAG_KEEP_TOUCH_MODE));
}
break;
}
}
}
}
}
}
3、“/apps” : 獲取盒子上安裝的APP數據列表,實現盒子APP的管理
代碼文件:AppRequestProcesser.java
參數:
system= 是否包含系統應用,true或false
調用示例:
POST /apps system=false
代碼實現:
通過PackageManager查詢盒子上安裝的APP列表,在處理列表數據的同時過濾掉系統底層的APP(非第三方)。
public static List<AppInfo> queryAppInfo(Context context, boolean containSysApp){
PackageManager pm = context.getPackageManager();
List<ApplicationInfo> listAppcations = pm
.getInstalledApplications(PackageManager.MATCH_UNINSTALLED_PACKAGES);
List<AppInfo> appInfos = new ArrayList<AppInfo>();
for (ApplicationInfo app : listAppcations) {
if(containSysApp || (app.flags & ApplicationInfo.FLAG_SYSTEM) == 0) {
boolean isSysApp = (app.flags & ApplicationInfo.FLAG_SYSTEM) != 0;
//過濾掉系統底層的app
if(isSysApp &&
(app.packageName.startsWith("com.android.") || app.packageName.equals("android")))continue;
AppInfo appInfo = new AppInfo();
appInfo.setLable((String) app.loadLabel(pm));
appInfo.setPackageName(app.packageName);
appInfo.setApkPath(app.sourceDir);
appInfo.setSysApp(isSysApp);
appInfos.add(appInfo);
}
}
Collections.sort(appInfos, new Comparator<AppInfo>() {
@Override
public int compare(AppInfo o1, AppInfo o2) {
int i1 = (o1.isSysApp ? 2 : 1);
int i2 = (o2.isSysApp ? 2 : 1);
if(i1 == i2){
return o1.getLable().compareTo(o2.getLable());
}else{
return Integer.compare(i1, i2);
}
}
});
return appInfos;
}
4、“/uninstall” : 卸載應用介面
代碼文件:AppRequestProcesser.java
參數:
packageName=卸載的應用包名
調用示例:
POST /uninstall packageName=com.test.app
代碼實現:
直接調用系統的卸載服務。
public static void uninstallPackage(final String packageName, final Context context){
if(getApplicationInfo(packageName, context) == null)return;;
try {
Intent intent = new Intent();
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setAction(Intent.ACTION_DELETE);
intent.setData(Uri.parse("package:" + packageName));
context.startActivity(intent);
Log.i(IMEService.TAG, String.format("已刪除應用包[%s]", packageName));
}catch (Exception ex){
Log.e(IMEService.TAG, String.format("刪除應用包[%s]出錯", packageName), ex);
}
}
5、“/run” ,“/runSystem”: 運行應用及或調用系統應用服務,如彈出系統設置界面。
代碼文件:AppRequestProcesser.java
參數:
packageName=要運行的應用包名
調用示例:
POST /run packageName=com.test.app
POST /runSystem packageName=android.settings.SETTINGS
代碼實現:
運行第三方應用則是通過PackageManager獲取包里的啟動頁後再運行,調用系統應用服務則是通過Intent直接啟動。
public static void runPackage(final String packageName, final Context context){
if(getApplicationInfo(packageName, context) == null)return;;
try {
PackageManager pm = context.getPackageManager();
Intent intent = pm.getLaunchIntentForPackage(packageName);
if(intent != null){
context.startActivity(intent);
}
Log.i(IMEService.TAG, String.format("已運行應用包[%s]", packageName));
}catch (Exception ex){
Log.e(IMEService.TAG, String.format("運行應用包[%s]出錯", packageName), ex);
}
}
public static void runSystemPackage(final String packageName, final Context context){
try {
Intent intent = new Intent(packageName);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
Log.i(IMEService.TAG, String.format("已運行系統應用包[%s]", packageName));
}catch (Exception ex){
Log.e(IMEService.TAG, String.format("運行系統應用包[%s]出錯", packageName), ex);
}
}
6、“/upload” : 文件傳送介面。“輸入遙控”界面下的文件傳送介面,如果傳送的為APK包則可自動安裝,如果為視頻文件或者種子文件則可自動播放。
代碼文件:UploadRequestProcesser.java
參數:
file=上傳的文件
autoPlay = 是否自動安裝APK包或者自動播放視頻及種子文件,true或者false
調用示例:
POST /upload -------
代碼實現:
直接通過NanoHTTPD的文件上傳功能實現,為避免跨"分區“移動文件,重寫了NanoHTTPD的TempFileManager實現,以便文件上傳時直接上傳到IMEService數據目錄下的files目錄。
代碼請參考RemoteServerFileManager.java文件
7、“/play” : 視頻播放服務介面
代碼文件:PlayRequestProcesser.java
參數:
playUrl=要播放的視頻源地址
調用示例:
POST /play playUrl=http://www.test.com/test.avi
代碼實現:
直接將視頻源地址傳入ijkplayer項目的播放器進行播放
XLVideoPlayActivity.intentTo(context, url, url);
8、“/file/dir/” : 文件管理介面服務,實現盒子的文件及目錄查看功能。
代碼文件:FileRequestProcesser.java
參數:
無
調用示例:
GET /file/dir/{查看的文件或者目錄路徑}
代碼實現:
獲取目錄下的子目錄及文件列表,返回JSON數據
private NanoHTTPD.Response responseDirData(String dirName) {
File path = new File(Environment.getExternalStorageDirectory(), dirName);
String root = Environment.getExternalStorageDirectory().getPath();
JSONArray dirs = new JSONArray();
JSONArray files = new JSONArray();
try {
File[] subfiles = path.listFiles();
Arrays.sort(subfiles, new Comparator<File>() {
@Override
public int compare(File f1, File f2) {
return f1.getName().toLowerCase().compareTo(f2.getName().toLowerCase());
}
});
for (File file : subfiles) {
if(file.isHidden()) continue;
JSONObject item = new JSONObject();
item.put("name", file.getName());
item.put("path", file.getPath().substring(root.length()));
if (file.isDirectory()) {
//item.put("total", 0);
dirs.put(item);
}else {
item.put("size", file.length());
files.put(item);
}
}
JSONObject data = new JSONObject();
if(!TextUtils.isEmpty(dirName) && dirName != "/") data.put("parent", path.getParent().substring(root.length()));
data.put("dirs", dirs);
data.put("files", files);
return RemoteServer.createJSONResponse(NanoHTTPD.Response.Status.OK, data.toString());
}catch (JSONException ex){
return RemoteServer.createPlainTextResponse(NanoHTTPD.Response.Status.INTERNAL_ERROR, "SERVER INTERNAL ERROR: JSONException: " + ex.getMessage());
}
}
9、“/file/download/” : 文件下載服務,實現盒子的文件下載功能。
代碼文件:FileRequestProcesser.java
參數:
無
調用示例:
GET /file/download/{下載的文件路徑}
代碼實現:
private NanoHTTPD.Response downloadFileData(String fileName){
File file = new File(Environment.getExternalStorageDirectory(), fileName);
if(!file.exists()){
return RemoteServer.createPlainTextResponse(NanoHTTPD.Response.Status.NOT_FOUND, "Error 404, file not found.");
}
try{
InputStream inputStream = new FileInputStream(file);
return RemoteServer.newFixedLengthResponse(NanoHTTPD.Response.Status.OK,
NanoHTTPD.getMimeTypeForFile(file.getName()) + "; charset=utf-8", inputStream, (long)inputStream.available());
} catch (Exception e) {
return RemoteServer.createPlainTextResponse(NanoHTTPD.Response.Status.NOT_FOUND, "Error 404, file not found.");
}
}
10、“/file/cut” ,“/file/copy”: 文件與目錄的剪切、複製服務。
代碼文件:FileRequestProcesser.java
參數:
paths = 要操作的目錄或者文件列表,多個之間用“|”分隔開
targetPath = 剪切或者移動的文件的新目標目錄
調用示例:
POST /file/cut
paths=/Download/a.txt&targetPath=/Andorid/data/
POST /file/copy
paths=/Download/a.txt&targetPath=/Andorid/data/
代碼實現:
private void batchCopyFile(String targetPath, String paths){
File targetPathFile = new File(Environment.getExternalStorageDirectory(), targetPath);
if(!targetPathFile.exists()) return;
String[] pathData = paths.split("\\|");
for(String p : pathData){
if(!TextUtils.isEmpty(p)) {
File source = new File(Environment.getExternalStorageDirectory(), p);
RemoteServerFileManager.copyFile(source, targetPathFile);
}
}
}
private void batchCutFile(String targetPath, String paths){
File targetPathFile = new File(Environment.getExternalStorageDirectory(), targetPath);
if(!targetPathFile.exists()) return;
String[] pathData = paths.split("\\|");
for(String p : pathData){
if(!TextUtils.isEmpty(p)) {
File source = new File(Environment.getExternalStorageDirectory(), p);
RemoteServerFileManager.cutFile(source, targetPathFile);
}
}
}
11、“/file/delete” : 文件或者目錄刪除服務,如果是目錄刪除則會一併刪除目錄下的所有子目錄和文件。
代碼文件:FileRequestProcesser.java
參數:
paths = 要刪除的文件或者目錄列表
調用示例:
POST /file/delete
paths=/Download/a.txt|/Download/test
代碼實現:
private void batchDeleteFile(String paths){
String[] pathData = paths.split("\\|");
for(String p : pathData){
if(!TextUtils.isEmpty(p)) {
File path = new File(Environment.getExternalStorageDirectory(), p);
RemoteServerFileManager.deleteFile(path);
}
}
}
12、“/file/upload” : 文件上傳服務。此介面和/upload介面類似,但是此介面是將文件上傳到文件管理界面下的當前目錄,並且不會安裝APK包和播放視頻文件。
代碼文件:FileRequestProcesser.java
參數:
file = 上傳的文件數據
path = 存儲上傳文件的目錄
調用示例:
POST /file/upload
--------
代碼實現:
文件上傳NanoHTTPD內部已實現好,因此只需要將上傳的文件移動到對應的目錄即可。
private NanoHTTPD.Response uploadFile(Map<String, String> params, Map<String, String> files){
String uploadFileName = params.get("file");
String uploadPathName = params.get("path");
String localFilename = files.get("file");
boolean r = false;
if(!TextUtils.isEmpty(uploadFileName)) {
if (!TextUtils.isEmpty(localFilename)) {
File saveFilename = new File(Environment.getExternalStorageDirectory(), uploadPathName);
File localFile = new File(localFilename);
saveFilename = new File(saveFilename,localFile.getName());
r = localFile.renameTo(saveFilename);
}
}
return RemoteServer.createJSONResponse(NanoHTTPD.Response.Status.OK, "{\"success\":" + (r ? "true": "false") + "}");
}
五:附註
項目地址:https://github.com/kingthy/TVRemoteIME
交流QQ群:7149348, 加入QQ群可以分享直播源、反饋問題及建議。