diff options
author | Treehugger Robot <treehugger-gerrit@google.com> | 2017-11-11 22:00:13 +0000 |
---|---|---|
committer | Gerrit Code Review <noreply-gerritcodereview@google.com> | 2017-11-11 22:00:13 +0000 |
commit | 5e20ba7b1c6a9644da034b345000b37856d78125 (patch) | |
tree | a2cfecc9e0c1d1e920487a04f1e91acc8e7dfd8b /java/com/android/dialer/precall/PreCallCoordinator.java | |
parent | 3d198bb28ae6b086f967619b25407f65a7f3ebe9 (diff) | |
parent | b0ed171b1c9d5b5d5e686b31be623c99ced15cf0 (diff) |
Merge changes Ide5ec431,Icf2f8fae
* changes:
Implement PreCallCoordinator
Make CallIntentBuilder parcelable
Diffstat (limited to 'java/com/android/dialer/precall/PreCallCoordinator.java')
-rw-r--r-- | java/com/android/dialer/precall/PreCallCoordinator.java | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/java/com/android/dialer/precall/PreCallCoordinator.java b/java/com/android/dialer/precall/PreCallCoordinator.java new file mode 100644 index 000000000..b5e9e8594 --- /dev/null +++ b/java/com/android/dialer/precall/PreCallCoordinator.java @@ -0,0 +1,68 @@ +/* + * Copyright (C) 2017 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 com.android.dialer.precall; + +import android.app.Activity; +import android.support.annotation.MainThread; +import android.support.annotation.NonNull; +import com.android.dialer.callintent.CallIntentBuilder; + +/** + * Runs {@link PreCallAction} one by one to prepare a {@link + * com.android.dialer.callintent.CallIntentBuilder} for a call. + */ +public interface PreCallCoordinator { + + @NonNull + CallIntentBuilder getBuilder(); + + /** + * @return the activity to attach the UI to. Returns {@link null} if the coordinator is running on + * headless mode. TODO(twyen): implement headless mode. + */ + @NonNull + Activity getActivity(); + + /** + * Called by a {@link PreCallAction} to abort the call. For example, the user has dismissed the + * dialog and must start over. + */ + void abortCall(); + + /** + * Callback from a {@link PreCallAction} to signal the action started by {@link + * PreCallCoordinator#startPendingAction()} has finished. + */ + interface PendingAction { + + @MainThread + void finish(); + } + + /** + * Called by the current running {@link PreCallAction} to release the main thread and resume + * pre-call later. + * + * @return a {@link PendingAction} which {@link PendingAction#finish(boolean)} should be called to + * resume pre-call. For example the action shows a dialog to the user, startPendingAction() + * should be called as the action will not be finished immediately. When the dialog is + * completed, {@code finish()} is then called to continue the next step. + */ + @MainThread + @NonNull + PendingAction startPendingAction(); +} |