快速入门

确认Endpoint

在使用SDK之前，需确认您将接入的百度云产品的Endpoint（服务域名）。以百度云服务器产品为例，可阅读EVS访问域名的部分，理解Endpoint相关的概念。其他服务类似，需理解并确认对应服务的Endpoint。

新建EvsClient

EvsClient是 EVS 服务的Java客户端，封装了Restful服务的通信细节，为开发者提供简单易用的交互工具。

下述示例代码用于新建一个EvsClient：

1public class Sample {
2    public static void main(String[] args) {
3        String ak = <your-access-key-id>;               // 用户的Access Key ID
4        String sk = <your-secret-access-key>;           // 用户的Secret Access Key
5      	String endpoint = <evs-endpoint>;								// EVS访问域名
6
7        // 初始化一个BccClient
8        BceClientConfiguration config = new BceClientConfiguration();
9        config.setCredentials(new DefaultBceCredentials(ak, sk));
10      	config.setEndpoint(endpoint);
11        EvsClient client = new EvsClient(config);
12        }
13}

在上面代码中，变量AK与SK是由系统分配给用户的，均为字符串，用于标识用户，为访问EVS做签名验证。 其中AK对应控制台中的“Access Key ID”，SK对应控制台中的“Access Key Secret”，获取方式请参考《操作指南 获取ACCESSKEY》。

配置

设置Protocol

• 通过调用setProtocol方法设置https协议：

  Java 复制

  1String endpoint = "evs.bj.baidubce.com"; // endpoint中不包含protocol
  2String ak = "ak";
  3String sk = "sk";
  4BceClientConfiguration config = new BceClientConfiguration();
  5config.setCredentials(new DefaultBceCredentials(ak, sk));
  6config.setEndpoint(endpoint);
  7config.setProtocol(Protocol.HTTPS); // 如果不指明, 则使用http
  8EvsClient client = new EvsClient(config);

• 在endpoint中指明了protocol：

  Java 复制

  1String endpoint = "http://evs.bj.baidubce.com";
  2String ak = "ak";
  3String sk = "sk";
  4BceClientConfiguration config = new BceClientConfiguration();
  5config.setCredentials(new DefaultBceCredentials(ak, sk));
  6config.setEndpoint(endpoint);    
  7config.setProtocol(Protocol.HTTPS); // endpoint中已经指明, 此为无效操作, 对http也是如此
  8EvsClient client = new EvsClient(config);

使用代理

下面一段代码可以让客户端使用代理访问EVS服务：

1String ak = <your-access-key-id>;               // 用户的Access Key ID
2String sk = <your-secret-access-key>;           // 用户的Secret Access Key
3String endpoint = <domain-name>;                // 用户自己指定的域名
4
5// 创建BceClientConfiguration实例
6BceClientConfiguration config = new BceClientConfiguration();
7
8// 配置代理为本地8080端口
9config.setProxyHost("127.0.0.1");
10config.setProxyPort(8080);
11
12// 创建EVS客户端
13config.setCredentials(new DefaultBceCredentials(ak, sk));
14config.setEndpoint(endpoint);
15EvsClient client = new EvsClient(config);

使用上面的代码段，客户端的所有操作都会通过127.0.0.1地址的8080端口做代理执行。 对于有用户验证的代理，可以通过下面的代码段配置用户名和密码：

1// 创建BceClientConfiguration实例
2BceClientConfiguration config = new BceClientConfiguration();
3
4// 配置代理为本地8080端口
5config.setProxyHost("127.0.0.1");
6config.setProxyPort(8080);
7
8//设置用户名和密码
9config.setProxyUsername(<username>);                             //用户名
10config.setProxyPassword(<password>);                             //密码

设置网络参数

用户可以用BceClientConfiguration对基本网络参数进行设置：

1BceClientConfiguration config = new BceClientConfiguration();
2
3// 设置HTTP最大连接数为10
4config.setMaxConnections(10);
5
6// 设置TCP连接超时为5000毫秒
7config.setConnectionTimeout(5000);
8
9// 设置Socket传输数据超时的时间为2000毫秒
10config.setSocketTimeout(2000);

配置参数说明

通过BceClientConfiguration能指定的所有参数如下表所示：