一、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群可以分享直播源、反饋問題及建議。