## NetworkService 网络服务接口用于控制目标 Pod 代理服务的启停，获取 Pod 的代理环境配置（如服务地址、鉴权 Token 与 TLS 证书等）并处理请求回调。 |接口名称 |接口描述 | |---|---| |setPodProxy(PodProxyRequest request, CommonCallback callback) |开启或关闭 Pod 网络代理：|\ | ||\ | |* request：代理请求参数。|\ | |* callback：请求结果回调。|\ | | * 0：调用成功。|\ | | * < 0：调用失败。 | |requestNetProxy(NetProxyListener listener) |请求获取当前拉流 Pod 的网络代理服务配置：|\ | ||\ | |* listener：请求结果回调。|\ | | * 0：调用成功。|\ | | * < 0：调用失败。 | |requestNetProxy(SinglePodTarget target, NetProxyListener listener) |请求获取指定目标 Pod 网络代理服务配置：|\ | ||\ | |* target：Pod 目标对象。|\ | |* listener：请求结果回调。|\ | | * 0：调用成功。|\ | | * < 0：调用失败。 | 参考示例： ```Java public interface NetworkService { int setPodProxy(@NonNull PodProxyRequest request, CommonCallback callback); int requestNetProxy(NetProxyListener listener); int requestNetProxy(@Nullable SinglePodTarget target, NetProxyListener listener); interface NetProxyListener { void onSuccess(@NonNull NetProxyParam param); void onError(int code, @NonNull String msg); } } ``` ### PodProxyRequest 设置 Pod 网络代理接口请求参数。 |参数 |类型 |描述 | |---|---|---| |STATUS_ON |Int |静态常量，值为 1，表示开启 Pod 网络代理。 | |STATUS_OFF |Int |静态常量，值为 0，表示关闭 Pod 网络代理。 | |proxyStatus |Int |Pod 网络代理状态，传入指定的常量值（STATUS_ON 或 STATUS_OFF）。 | |proxyConfig |Map |Pod 网络代理配置，设置代理服务参见 [SetProxy](https://www.volcengine.com/docs/6394/2189020?lang=zh)。|\ | | |:::warning|\ | | ||\ | | |* 当 `proxyStatus` 为 `STATUS_ON` 时此参数必填。|\ | | |* 当 `proxyStatus` 为 `STATUS_OFF` 时此参数可不填写。|\ | | ||\ | | |:::| |target |BatchPodTarget |需要操作的目标 Pod 资源，参见 [BatchPodTarget](https://www.volcengine.com/docs/6394/2407078?lang=zh#ZwFwfuc6)。|\ | | ||\ | | |* 传入 `target` 时，支持指定 `podList` 进行批量操作。|\ | | |* 不传入 `target` 时为空，默认 `podList` 为当前正在拉流的 Pod，对其进行操作。 | 参考示例： ```Java public final class PodProxyRequest { public static final int STATUS_ON = 1; public static final int STATUS_OFF = 0; private int proxyStatus; private Map proxyConfig; private @Nullable BatchPodTarget target; } ``` #### 批量操作目标 Pod 资源（BatchPodTarget） |参数 |类型 |描述 | |---|---|---| |accountId |String |资源归属的 ID。 | |productId |String |资源归属的产品线或业务线 ID。 | |podList |Set |目标 Pod 的 ID 集合，用于指定需要批量操作的 Pod 列表。 | |ak |String |火山引擎资源访问的鉴权信息，Access Key ID。 | |sk |String |火山引擎资源访问的鉴权信息，Secret Access Key。 | |token |String |火山引擎资源访问的鉴权信息，安全令牌（Session Token）。 | 参考示例： ```Java public final class BatchPodTarget { private String accountId, productId; private Set podList; private String ak, sk, token; } ``` #### 操作单个目标 Pod 资源（SinglePodTarget） |参数 |类型 |描述 | |---|---|---| |accountId |String |资源归属的 ID。 | |productId |String |资源归属的产品线或业务线 ID。 | |podId |String |操作目标 Pod 的 ID。 | |ak |String |火山引擎资源访问的鉴权信息，Access Key ID。 | |sk |String |火山引擎资源访问的鉴权信息，Secret Access Key。 | |token |String |火山引擎资源访问的鉴权信息，安全令牌（Session Token）。 | 参考示例： ```Java public final class SinglePodTarget { private String accountId, productId, podId; private String ak, sk, token; } ``` ### NetProxyParam 设置 Pod 网络代理核心参数。 |参数 |类型 |描述 | |---|---|---| |podId |String |目标 Pod 的 ID。 | |url |String |代理服务器的连接地址。 | |authToken |String |代理服务的访问鉴权凭证（Token）。 | |proxyType |String |代理服务的网络协议类型（如 TCP）。 | |proxyPluginType |String |代理服务使用的底层插件类型（如 Socks5）。 | |tlsServerCertPath |String |代理服务端的 TLS 证书文件路径。 | |tlsClientCertPath |String |代理客户端的 TLS 证书文件路径。 | |tlsClientKeyPath |String |代理客户端的 TLS 私钥文件路径。 | |tlsServerName |String |代理服务端的 TLS 校验名称（Server Name）。 | 参考示例： ```Java public final class NetProxyParam { private final String podId; private final String url; private final String authToken; private final String proxyType; private final String proxyPluginType; private final String tlsServerCertPath; private final String tlsClientCertPath; private final String tlsClientKeyPath; private final String tlsServerName; } ``` ## 示例代码开启 Pod 网络重定向，并启动客户端的网络代理服务，代码示例如下： ```Java @Override public void onServiceInit(@NonNull Map extras) { NetworkService service = VePhoneEngine.getInstance().getNetworkService(); if (service == null) { return; } // 是否在退出拉流时自动关闭 veproxy 网络代理 boolean autoStopVeProxy = AppSettings.getVeProxySwitcher(); // 第一步：开启 Pod 网络重定向 service.requestNetProxy(new NetworkService.NetProxyListener() { @Override public void onSuccess(@NonNull NetProxyParam param) { ProxyProfile profile = createProxyProfileByParam(param); // 第二步：开启网络重定向获取 NetProxyParam，启动客户端网络代理。 // 请参考 Veproxy SDK 按需自行引入工程 VeProxyClient.getInstance().start(context, profile); // 退出拉流时，自动停止 frpc 并关闭 Pod 网络代理劫持 if (autoStopVeProxy) { // releaseTasks 需要业务方自己实现，需在调用 VePhoneEngine.getInstance().stop() 前先执行 releaseTasks releaseTasks.add(() -> { // 先关闭 veproxy 网络代理服务 VeProxyClient.getInstance().stop(context, profile); // 再关闭 Pod 代理服务 onSetPodProxyOff(); }); } } @Override public void onError(int code, @NonNull String msg) { Log.d(TAG, "requestNetProxy#onError: code:" + code + ", msg:" + msg); } }); } // 将 NetProxyParam 转化为 ProxyProfile。 private ProxyProfile createProxyProfileByParam(@NonNull NetProxyParam param) { // 以下是固定写法 return new ProxyProfile.Builder() .stopProxyWhenDisconnected(false) .serverAddr(param.getServerHost()) .serverPort(param.getServerPort()) .auth(new AuthConfig.Builder().method(AuthMethod.TOKEN).token(param.getAuthToken()).build()) .transport( new TransportConfig.Builder() .protocol(TransportProtocol.WSS) .websocketPath(param.getServerFullPath()) .tls(new Tls.Builder() .certFile(param.getTlsClientCertPath()) .keyFile(param.getTlsClientKeyPath()) .trustedCaFile(param.getTlsServerCertPath()) .serverName(param.getTlsServerName()) .build()) .build() ) .proxy( new ProxyConfig.Builder() .name(param.getPodId()) // 必须，固定写法 .type(ProxyType.TCP) .plugin(new Socks5Plugin()) .transport( // 对代理网络的带宽进行合理限制，防止影响客户端拉流 new ProxyTransport.Builder() .bandwidthLimit("2MB") .useEncryption(true) .useCompression(true) .build() ) .build() ) .build(); } // 关闭 Pod 网络代理 private void onSetPodProxyOffViaOpenApi(){ // 方式一（推荐）：随时可调用 setProxy 接口实现关闭 Pod 代理。 } private void onSetPodProxyOffViaSdk(){ // 方式二：处于拉流状态时，可使用如下代码调用 SDK 接口。 // 注意：调用 VePhoneEngine.getInstance().stop() 会取消 SDK 内部所有网络通讯，可能造成 SDK 接口调用失败。 NetworkService service = VePhoneEngine.getInstance().getNetworkService(); if (service == null) { return; } service.setPodProxy( new PodProxyRequest.Builder() .proxyStatus(PodProxyRequest.STATUS_OFF) .build(), new CommonCallback() { public void onSuccess(@NonNull JSONObject result) { showToast("解除代理成功"); } public void onFailure(int code, String error) { showToast("解除代理失败: " + error); } } ); } ```

云手机