友机互联网 - 远程intenting

友机互联网提供类似的API来发送远程Intents,应用程序应该在AndroidManifest.xml中添加此权限：

<uses-permission android:name="com.xconns.peerdevicenet.permission.REMOTE_INTENT" />

请注意，当应用程序发送远程 intents 时，基于安全的原因，发送的 intents 不能直接使用设备的某些功能，例如摄像头，GPS等，因为这些功能需要特定的系统权限，友机互联网可能没有。对于有这样需要的 intents，我们应该使用特别约定的intent，将它传送给接收设备的应用程序。在接收的一端，要有一个应用程序，已经申请必要的系统权限，然后将接收到的特定的 intents 翻译成相应的系统的 intents。请参照在 RemoteIntentDemo 应用程序的范例中，intents ACTION_DIAL 和 ACTION_CALL 是怎样处理的。

应用程序可以调用 startActivity（）/ startService（），并使用一个“载体”intent。 “载体”intent 的内容定义如下：

远程的intent actions：

ACTION_START_REMOTE_ACTIVITY =“com.xconns.peerdevicenet.START_REMOTE_ACTIVITY”
ACTION_START_REMOTE_ACTIVITY_FOR_RESULT =“com.xconns.peerdevicenet.START_REMOTE_ACTIVITY_FOR_RESULT”
ACTION_START_REMOTE_SERVICE =“com.xconns.peerdevicenet.START_REMOTE_SERVICE”
ACTION_SEND_REMOTE_BROADCAST =“com.xconns.peerdevicenet.SEND_REMOTE_BROADCAST”

将需要传递的远程intent 加入“载体”,作为一个名为 “REMOTE_INTENT”的数据项目来传输：

carrierIntent.putExtra（“REMOTE_INTENT”，remote_intent）;

设定目标设备的参数 (当使用startActivity() 时可以省去)

carrierIntent.putExtra（PEER_NAME，...）;
carrierIntent.putExtra（PEER_ADDR，...）;
carrierIntent.putExtra（PEER_PORT，...）;

设定软件包的名字 (可省去)

arrierIntent.putExtra(PACKAGE_NAME, ...);

当用 startService（）发送远程 intent 时，必须设置目标设备的参数
当用 startActivity（）发送远程 intent 时，如果设定的目标设备已经连接好，友机互联网会直接发送信息；否则，友机互联网会列出所有已经连接好的设备，用户可以选择一个或者多个设备作为发送目标。
如果远程 intent设定了软件包的名字，而且在接收设备上没有应用程序能够处理这个intent，友机互联网会提示去应用程序商店安装这个应用。

请参考 RemoteIntentDemo 的应用程序，了解如何使用startActivity（）发送远程 intent。用户也可以从谷歌Play直接安装使用这个程序。

使用IDL API的应用程序，需要绑定到以下服务：

ACTION_REMOTE_INTENT_SERVICE =“com.xconns.peerdevicenet.RemoteIntentService”

这项服务将提供以下的异步界面：

IRemoteIntentService {
oneway void startRemoteActivity(in DeviceInfo device, in Intent intent, IRemoteIntentHandler h);
oneway void startRemoteActivityForResult(in DeviceInfo device, in Intent intent, IRemoteIntentHandler h);
oneway void startRemoteService(in DeviceInfo device, in Intent intent, IRemoteIntentHandler h);
oneway void sendRemoteBroadcast(in DeviceInfo device, in Intent intent, IRemoteIntentHandler h);
oneway void cancelSession(int sessionId);
}

使用这项服务的应用程序，需要登记具有以下界面的处理程序，来处理发送远程 intent 的各种状态:

IRemoteIntentHandler {
oneway void onError(in String errInfo);
    oneway void onResult(in Intent result);
    oneway void onStart(int sessionId);
    oneway void onProgress(int percent);
    oneway void onComplete();
    oneway void onRejected();
    oneway void onCanceled();
}

请参考这个使用IDL API发送远程 intent的应用程序。

远程intenting API