Package org.linphone.core

Interface ChatParams

public interface ChatParams
Object defining settings strictly associated with ChatRoom objects such
as ephemeral settings and backends.

It is automatically created when you enable chat capabilities in the ConferenceParams
.
If the ChatRoom backend is {@link ChatRoom#Backend#Basic}, then no
other parameter is required, but ChatMessage sent and received won't
benefit from all features a {@link ChatRoom#Backend#FlexisipChat} can offer
like conversation with multiple participants and a subject, end-to-end
encryption, ephemeral messages, etc... but this type is the only one that can
interoperate with other SIP clients or with non-flexisip SIP proxies.

  • Method Summary

    Modifier and Type
    Method
    Description
    ChatParams
    clone()
    Clone a ChatParams.
    ChatRoom.Backend
    getBackend()
    Get the backend implementation of the text capabilities of the chat associated
    with the given parameters.
    ChatRoom.EncryptionBackend
    getEncryptionBackend()
    Get the encryption implementation of the text capabilities of the chat
    associated with the given parameters.
    long
    getEphemeralLifetime()
    Get lifetime (in seconds) for all new ephemeral messages in the text
    capabilities of the chat.
    ChatRoom.EphemeralMode
    getEphemeralMode()
    Get the ephemeral message mode of the text capabilities of the chat associated
    with the given parameters.
    long
    getNativePointer()
    Gets the native pointer used by this class to make native method calls.
    Object
    getUserData()
    Gets the object stored in this object user's data
    boolean
    isEncryptionEnabled()
    Get the encryption status of the text capabilities of the chat associated with
    the given parameters.
    boolean
    isRttEnabled()
    Get the real time text status of the text capabilities of the chat associated
    with the given parameters.
    void
    setBackend(ChatRoom.Backend backend)
    Set the backend implementation of these text capabilities of the chat
    parameters.
    void
    setEncryptionBackend(ChatRoom.EncryptionBackend backend)
    Set the encryption backend implementation of these text capabilities of the
    chat parameters.
    void
    setEphemeralLifetime(long time)
    Set lifetime (in seconds) for all new ephemral messages in the text
    capabilities of the chat.
    void
    setEphemeralMode(ChatRoom.EphemeralMode mode)
    Enables or disables forcing of ephemeral messages for the text capabilities of
    the chat associated with the given parameters.
    void
    setRttEnabled(boolean rtt)
    Enables or disables real time text for the text capabilities of the chat
    associated with the given parameters.
    void
    setUserData(Object data)
    Sets the object to store in this object user's data
    String
    toString()
     

  • Method Details

    • getBackend

      ChatRoom.Backend getBackend()
      Get the backend implementation of the text capabilities of the chat associated
      with the given parameters.

      Returns:
      the ChatRoom#Backend

    • setBackend

      void setBackend(ChatRoom.Backend backend)
      Set the backend implementation of these text capabilities of the chat
      parameters.

      Parameters:
      backend - The ChatRoom#Backend enum value

    • getEncryptionBackend

      ChatRoom.EncryptionBackend getEncryptionBackend()
      Get the encryption implementation of the text capabilities of the chat
      associated with the given parameters.

      Returns:
      the ChatRoom#EncryptionBackend

    • setEncryptionBackend

      void setEncryptionBackend(ChatRoom.EncryptionBackend backend)
      Set the encryption backend implementation of these text capabilities of the
      chat parameters.

      Parameters:
      backend - The ChatRoom#EncryptionBackend enum value

    • isEncryptionEnabled

      boolean isEncryptionEnabled()
      Get the encryption status of the text capabilities of the chat associated with
      the given parameters.

      Returns:
      true if encryption is enabled, false otherwise

    • getEphemeralLifetime

      long getEphemeralLifetime()
      Get lifetime (in seconds) for all new ephemeral messages in the text
      capabilities of the chat.

      After the message is read, it will be deleted after "time" seconds. see:
      linphone_chat_params_ephemeral_enabled()
      Returns:
      the ephemeral lifetime (in seconds)

    • setEphemeralLifetime

      void setEphemeralLifetime(long time)
      Set lifetime (in seconds) for all new ephemral messages in the text
      capabilities of the chat.

      After the message is read, it will be deleted after "time" seconds. see:
      linphone_chat_params_ephemeral_enabled()
      Parameters:
      time - The ephemeral lifetime, default is disabled (0)

    • getEphemeralMode

      ChatRoom.EphemeralMode getEphemeralMode()
      Get the ephemeral message mode of the text capabilities of the chat associated
      with the given parameters.

      Returns:
      the ephemeral message mode ChatRoom#EphemeralMode

    • setEphemeralMode

      void setEphemeralMode(ChatRoom.EphemeralMode mode)
      Enables or disables forcing of ephemeral messages for the text capabilities of
      the chat associated with the given parameters.

      Parameters:
      mode - Ephemeral message mode ChatRoom#EphemeralMode.

    • isRttEnabled

      boolean isRttEnabled()
      Get the real time text status of the text capabilities of the chat associated
      with the given parameters.

      Returns:
      true if real time text is enabled, false otherwise

    • setRttEnabled

      void setRttEnabled(boolean rtt)
      Enables or disables real time text for the text capabilities of the chat
      associated with the given parameters.

      Parameters:
      rtt - true to enable real time text, false to disable.

    • clone

      @NonNull ChatParams clone()
      Clone a ChatParams.

      Returns:
      An allocated ChatParams with the same parameters than params

    • setUserData

      void setUserData(Object data)
      Sets the object to store in this object user's data
      Parameters:
      data - the object to store

    • getUserData

      Object getUserData()
      Gets the object stored in this object user's data
      Returns:
      the object store if any, null otherwise

    • getNativePointer

      long getNativePointer()
      Gets the native pointer used by this class to make native method calls.
      Returns:
      the nativer pointer, as long

    • toString

      String toString()
      Overrides:
      toString in class Object