src/com/android/im/IChatSessionManager.aidl

   1 /*
   2  * Copyright (C) 2007-2008 Esmertec AG.
   3  * Copyright (C) 2007-2008 The Android Open Source Project
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *      http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 package com.android.im;
  19
  20 import com.android.im.IChatSession;
  21 import com.android.im.IChatSessionListener;
  22
  23 interface IChatSessionManager {
  24     void registerChatSessionListener(IChatSessionListener listener);
  25     void unregisterChatSessionListener(IChatSessionListener listener);
  26
  27     /**
  28      * Create a ChatSession with the specified contact. If the contact does not exist in any
  29      * of the user's contact lists, it will be added to the temporary list.
  30      *
  31      * @param contactAddress the address of the contact.
  32      */
  33     IChatSession createChatSession(String contactAddress);
  34
  35     /**
  36      * Get the ChatSession that is associated with the specified contact or group.
  37      *
  38      * @param the address of the contact or group.
  39      * @return the ChatSession with the contact or group or <code>null</code> if
  40      *       there isn't any active ChatSession with the contact or group.
  41      */
  42     IChatSession getChatSession(String address);
  43
  44     /**
  45      * Get a list of all active ChatSessions.
  46      *
  47      * @return a list of IBinders of all active ChatSessions.
  48      */
  49     List getActiveChatSessions();
  50 }