Android官方培训课程中文版(v0.9.7)

访问可穿戴数据层

编写:wly2014 - 原文: http://developer.android.com/training/wearables/data-layer/accessing.html

调用数据层API,需创建一个 GoogleApiClient 实例,所有 Google Play services APIs的主要入口点。

GoogleApiClient 提供了一个易于创建客户端实例的builder。最简单的GoogleApiClient如下:

Note: 目前,此小client仅足以能启动。但是,更多创建GoogleApiClient,实现回调方法和处理错误等内容,详见 Accessing Google Play services APIs

GoogleApiClient mGoogleApiClient = new GoogleApiClient.Builder(this)
        .addConnectionCallbacks(new ConnectionCallbacks() {
                @Override
                public void onConnected(Bundle connectionHint) {
                    Log.d(TAG, "onConnected: " + connectionHint);
                    // Now you can use the Data Layer API
                }
                @Override
                public void onConnectionSuspended(int cause) {
                    Log.d(TAG, "onConnectionSuspended: " + cause);
                }
        })
        .addOnConnectionFailedListener(new OnConnectionFailedListener() {
                @Override
                public void onConnectionFailed(ConnectionResult result) {
                    Log.d(TAG, "onConnectionFailed: " + result);
                }
            })
        // Request access only to the Wearable API
        .addApi(Wearable.API)
        .build();

Important: 如果我们添加多个API到一个GoogleApiClient,那么可能会在没有安装Android Wear app 的设备上遇到连接错误。为了连接错误,调用addApiIfAvailable()方法,并以Wearable API为参数传进该方法,从而表明client应该处理缺失的API。更多的信息,请见 Access the Wearable API.

在使用数据层API之前,通过调用connect())方法进行连接,如 Start a Connection 中所述。当系统为我们的客户端调用了onConnected()) 方法,我们就可以使用数据层API了。