OLD | NEW |
(Empty) | |
| 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. |
| 4 |
| 5 package org.chromium.chrome.browser.hosted; |
| 6 |
| 7 import android.os.Bundle; |
| 8 |
| 9 /** |
| 10 * Interface for communicating between a browser background service and another
application. |
| 11 */ |
| 12 interface IBrowserConnectionService { |
| 13 /** |
| 14 * Sets the callback triggered on an external navigation. |
| 15 * |
| 16 * Must be called right after the service connection, and must be called |
| 17 * again if the service gets disconnected. Only one call to this method is |
| 18 * allowed, following ones will return an error. |
| 19 * Must be called before the VIEW intent is sent to the browser. |
| 20 * |
| 21 * @param callback Callback to be called, null if no callback is wanted. |
| 22 * @return 0 for success. |
| 23 */ |
| 24 long finishSetup(IBrowserConnectionCallback callback); |
| 25 |
| 26 /** |
| 27 * Warms up the browser process. |
| 28 * |
| 29 * Warmup is asynchronous, the return value indicates that the request has b
een accepted. |
| 30 * |
| 31 * @param flags Reserved for future use. |
| 32 * @return 0 for success. |
| 33 */ |
| 34 long warmup(long flags); |
| 35 |
| 36 /** |
| 37 * @return A negative number to signal an error, or a positive new session I
D. |
| 38 */ |
| 39 long newSession(); |
| 40 |
| 41 /** |
| 42 * Tells the browser of a likely future navigation to a URL. |
| 43 * |
| 44 * The method {@link warmup} has to be called first. |
| 45 * The most likely URL has to be specified first. Optionally, a list of |
| 46 * other likely URLs can be provided. They are treated as less likely than |
| 47 * the first one, and have to be sorted in decreasing priority order. These |
| 48 * additional URLs may be ignored. |
| 49 * All previous calls to this method will be deprioritized. |
| 50 * |
| 51 * @param sessionId As returned by {@link newSession}. |
| 52 * @param url Most likely URL. |
| 53 * @param extras Reserved for future use. |
| 54 * @param otherLikelyBundles Other likely destinations, sorted in decreasing |
| 55 * likelihood order. Each Bundle has to provide a "url" String value. |
| 56 * @return sessionId if it is known by the service, a number <0 to signal an
error. |
| 57 */ |
| 58 long mayLaunchUrl( |
| 59 long sessionId, String url, in Bundle extras, in List<Bundle> otherL
ikelyBundles); |
| 60 } |
OLD | NEW |