1 /*
2  * Copyright (C) 2024 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 
17 package android.provider;
18 
19 import android.annotation.FlaggedApi;
20 import android.annotation.NonNull;
21 import android.annotation.SystemApi;
22 
23 import com.android.providers.media.flags.Flags;
24 
25 import java.util.List;
26 
27 
28 /**
29  * <p> A callback interface passed to {@link MediaCognitionService} functions which will be
30  * used to return results for the methods
31  * {@link MediaCognitionService#onProcessMedia(List, android.os.CancellationSignal, MediaCognitionProcessingCallback)}. </p>
32  *
33  * @hide
34  */
35 @SystemApi
36 @FlaggedApi(Flags.FLAG_MEDIA_COGNITION_SERVICE)
37 public interface MediaCognitionProcessingCallback {
38     /**
39      * Call this on success response of {@link MediaCognitionService#onProcessMedia}
40      *
41      * @param responses Return a list of {@link MediaCognitionProcessingResponse} based on the list
42      *                  of {@link MediaCognitionProcessingRequest}. These requests are made through
43      *                  {@link MediaCognitionService#onProcessMedia}
44      *
45      */
onSuccess(@onNull List<MediaCognitionProcessingResponse> responses)46     void onSuccess(@NonNull List<MediaCognitionProcessingResponse> responses);
47 
48     /**
49      * Call this on failure of the request from MediaCognitionService
50      * @param message Failure message
51      */
onFailure(@onNull String message)52     void onFailure(@NonNull String message);
53 }
54