framework/java/android/bluetooth/BluetoothHealthCallback.java

/*
 * Copyright (C) 2011 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.bluetooth;

import android.annotation.BinderThread;
import android.os.ParcelFileDescriptor;
import android.util.Log;

/**
 * This abstract class is used to implement {@link BluetoothHealth} callbacks.
 *
 * @deprecated Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should use
 *     Bluetooth Low Energy based solutions such as {@link BluetoothGatt}, {@link
 *     BluetoothAdapter#listenUsingL2capChannel()}, or {@link
 *     BluetoothDevice#createL2capChannel(int)}
 */
@Deprecated
public abstract class BluetoothHealthCallback {
    private static final String TAG = BluetoothHealthCallback.class.getSimpleName();

    /**
     * Callback to inform change in registration state of the health application.
     *
     * <p>This callback is called on the binder thread (not on the UI thread)
     *
     * @param config Bluetooth Health app configuration
     * @param status Success or failure of the registration or unregistration calls. Can be one of
     *     {@link BluetoothHealth#APP_CONFIG_REGISTRATION_SUCCESS} or {@link
     *     BluetoothHealth#APP_CONFIG_REGISTRATION_FAILURE} or {@link
     *     BluetoothHealth#APP_CONFIG_UNREGISTRATION_SUCCESS} or {@link
     *     BluetoothHealth#APP_CONFIG_UNREGISTRATION_FAILURE}
     * @deprecated Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should
     *     use Bluetooth Low Energy based solutions such as {@link BluetoothGatt}, {@link
     *     BluetoothAdapter#listenUsingL2capChannel()}, or {@link
     *     BluetoothDevice#createL2capChannel(int)}
     */
    @BinderThread
    @Deprecated
    public void onHealthAppConfigurationStatusChange(
            BluetoothHealthAppConfiguration config, int status) {
        Log.d(TAG, "onHealthAppConfigurationStatusChange: " + config + "Status: " + status);
    }

    /**
     * Callback to inform change in channel state.
     *
     * <p>It's the responsibility of the implementer of this callback to close the parcel file
     * descriptor when done. This callback is called on the Binder thread (not the UI thread)
     *
     * @param config The Health app configuration
     * @param device The Bluetooth Device
     * @param prevState The previous state of the channel
     * @param newState The new state of the channel.
     * @param fd The Parcel File Descriptor when the channel state is connected.
     * @param channelId The id associated with the channel. This id will be used in future calls
     *     like when disconnecting the channel.
     * @deprecated Health Device Profile (HDP) and MCAP protocol are no longer used. New apps should
     *     use Bluetooth Low Energy based solutions such as {@link BluetoothGatt}, {@link
     *     BluetoothAdapter#listenUsingL2capChannel()}, or {@link
     *     BluetoothDevice#createL2capChannel(int)}
     */
    @BinderThread
    @Deprecated
    public void onHealthChannelStateChange(
            BluetoothHealthAppConfiguration config,
            BluetoothDevice device,
            int prevState,
            int newState,
            ParcelFileDescriptor fd,
            int channelId) {
        Log.d(
                TAG,
                "onHealthChannelStateChange: "
                        + config
                        + "Device: "
                        + device
                        + "prevState:"
                        + prevState
                        + "newState:"
                        + newState
                        + "ParcelFd:"
                        + fd
                        + "ChannelId:"
                        + channelId);
    }
}