1 /* 2 * Copyright (C) 2018 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 package com.android.server.contentcapture; 17 18 import android.annotation.NonNull; 19 import android.annotation.Nullable; 20 import android.annotation.UserIdInt; 21 import android.app.assist.ActivityId; 22 import android.content.ComponentName; 23 import android.content.ContentCaptureOptions; 24 import android.os.Bundle; 25 import android.os.IBinder; 26 import android.service.contentcapture.ActivityEvent.ActivityEventType; 27 28 /** 29 * ContentCapture Manager local system service interface. 30 * 31 * @hide Only for use within the system server. 32 */ 33 public abstract class ContentCaptureManagerInternal { 34 35 /** 36 * Checks whether the given {@code uid} owns the 37 * {@link android.service.contentcapture.ContentCaptureService} implementation associated with 38 * the given {@code userId}. 39 */ isContentCaptureServiceForUser(int uid, @UserIdInt int userId)40 public abstract boolean isContentCaptureServiceForUser(int uid, @UserIdInt int userId); 41 42 /** 43 * Notifies the intelligence service of new assist data for the given activity. 44 * 45 * @return {@code false} if there was no service set for the given user 46 */ sendActivityAssistData(@serIdInt int userId, @NonNull IBinder activityToken, @NonNull Bundle data)47 public abstract boolean sendActivityAssistData(@UserIdInt int userId, 48 @NonNull IBinder activityToken, @NonNull Bundle data); 49 50 /** 51 * Gets the content capture options for the given user and package, or {@code null} if the 52 * package is not allowlisted by the service. 53 * 54 * <p><b>NOTE: </b>this method is called by the {@code ActivityManager} service and hence cannot 55 * hold the main service lock. 56 */ 57 @Nullable getOptionsForPackage(@serIdInt int userId, @NonNull String packageName)58 public abstract ContentCaptureOptions getOptionsForPackage(@UserIdInt int userId, 59 @NonNull String packageName); 60 61 /** 62 * Notifies the intelligence service of a high-level activity event for the given user. 63 */ notifyActivityEvent(@serIdInt int userId, @NonNull ComponentName activityComponent, @ActivityEventType int eventType, @NonNull ActivityId activityId)64 public abstract void notifyActivityEvent(@UserIdInt int userId, 65 @NonNull ComponentName activityComponent, @ActivityEventType int eventType, 66 @NonNull ActivityId activityId); 67 } 68