1 /* 2 * Copyright (c) 2019, The Android Open Source Project 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * - Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * - Redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution. 12 * - Neither the name of The Android Open Source Project nor the names of its contributors may 13 * be used to endorse or promote products derived from this software 14 * without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 18 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 19 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MOTOROLA MOBILITY LLC BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 26 * DAMAGE. 27 */ 28 29 package com.android.service.ims.presence; 30 31 import android.telephony.ims.RcsContactUceCapability; 32 33 public interface PresencePublisher { 34 35 /** 36 * Notify the stack of the last publish request result. 37 */ getPublisherState()38 @PresenceBase.PresencePublishState int getPublisherState(); 39 40 /** 41 * Request that the specified capabilities are published to the network. 42 * @param capabilities The capabilities to publish. 43 * @param contactUri The contactUri that will be used to publish capabilities. 44 * @param taskId The presence task associated with this request. 45 * @return the result of requesting that the capabilities are published. 46 */ requestPublication(RcsContactUceCapability capabilities, String contactUri, int taskId)47 int requestPublication(RcsContactUceCapability capabilities, String contactUri, int taskId); 48 49 /** 50 * Notify the stack of the last publish or subscribe request result. 51 */ updatePublisherState(@resenceBase.PresencePublishState int publishState)52 void updatePublisherState(@PresenceBase.PresencePublishState int publishState); 53 } 54