| /* |
| * Copyright (C) 2020 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.companion; |
| |
| import android.annotation.MainThread; |
| import android.annotation.NonNull; |
| import android.annotation.Nullable; |
| import android.app.Service; |
| import android.content.Intent; |
| import android.os.Handler; |
| import android.os.IBinder; |
| import android.util.Log; |
| |
| import com.android.internal.util.function.pooled.PooledLambda; |
| |
| import java.util.Objects; |
| |
| /** |
| * Service to be implemented by apps that manage a companion device. |
| * |
| * System will keep this service bound whenever an associated device is nearby, |
| * ensuring app stays alive. |
| * |
| * An app must be {@link CompanionDeviceManager#associate associated} with at leas one device, |
| * before it can take advantage of this service. |
| * |
| * You must declare this service in your manifest with an |
| * intent-filter action of {@link #SERVICE_INTERFACE} and |
| * permission of {@link android.Manifest.permission#BIND_COMPANION_DEVICE_SERVICE} |
| */ |
| public abstract class CompanionDeviceService extends Service { |
| |
| private static final String LOG_TAG = "CompanionDeviceService"; |
| |
| /** |
| * An intent action for a service to be bound whenever this app's companion device(s) |
| * are nearby. |
| * |
| * <p>The app will be kept alive for as long as the device is nearby. |
| * If the app is not running at the time device gets connected, the app will be woken up.</p> |
| * |
| * <p>Shortly after the device goes out of range, the service will be unbound, and the |
| * app will be eligible for cleanup, unless any other user-visible components are running.</p> |
| * |
| * <p>An app shouldn't declare more than one of these services. |
| * If running in background is not essential for the devices that this app can manage, |
| * app should avoid declaring this service.</p> |
| * |
| * <p>The service must also require permission |
| * {@link android.Manifest.permission#BIND_COMPANION_DEVICE_SERVICE}</p> |
| */ |
| public static final String SERVICE_INTERFACE = "android.companion.CompanionDeviceService"; |
| |
| private final Stub mRemote = new Stub(); |
| |
| /** |
| * Called by system whenever a device associated with this app is available. |
| * |
| * @param address the MAC address of the device |
| */ |
| @MainThread |
| public abstract void onDeviceAppeared(@NonNull String address); |
| |
| /** |
| * Called by system whenever a device associated with this app stops being available. |
| * |
| * Usually this means the device goes out of range or is turned off. |
| * |
| * @param address the MAC address of the device |
| */ |
| @MainThread |
| public abstract void onDeviceDisappeared(@NonNull String address); |
| |
| @Nullable |
| @Override |
| public final IBinder onBind(@NonNull Intent intent) { |
| if (Objects.equals(intent.getAction(), SERVICE_INTERFACE)) { |
| return mRemote; |
| } |
| Log.w(LOG_TAG, |
| "Tried to bind to wrong intent (should be " + SERVICE_INTERFACE + "): " + intent); |
| return null; |
| } |
| |
| class Stub extends ICompanionDeviceService.Stub { |
| |
| @Override |
| public void onDeviceAppeared(String address) { |
| Handler.getMain().sendMessage(PooledLambda.obtainMessage( |
| CompanionDeviceService::onDeviceAppeared, |
| CompanionDeviceService.this, address)); |
| } |
| |
| @Override |
| public void onDeviceDisappeared(String address) { |
| Handler.getMain().sendMessage(PooledLambda.obtainMessage( |
| CompanionDeviceService::onDeviceDisappeared, |
| CompanionDeviceService.this, address)); |
| } |
| } |
| } |