:Voice intercom

Prerequisites

• A product and device are created in the IoT Platform console. For more information, see Device Connection.

• LinkVisual SDK is obtained. For more information, see Obtain the SDK.

• LinkVisual SDK is initialized. For more information, see Initialize the SDK.

Audio coding standards

Voice intercom supports G711a, G711u, and Advanced Audio Coding Low Complexity (AAC-LC) codecs. These coding standards have the following characteristics:

• Support the sample rates of 8 kHz and 16 kHz.

• Support encoding.

• Support decoding.

Voice intercom modes

The following table describes the voice intercom modes and usage notes.

Procedure

After the server sends the command to start stream ingest, perform the following operations:

• Use the OnLiveIntercomListener listener that you registered to notify the IP camera of events, such as starting voice intercom, stopping voice intercom, receiving audio parameters, and receiving audio data.

• Use a listener to listen to errors that occur in stream ingest, and notify the app.

  Important

  Do not block callbacks.

Implementation process:

1. Select a voice intercom mode.

   // Select the two-way voice intercom mode.
   IPCDev.getInstance().setLiveIntercomModeBeforeInit(IPCLiveIntercomV2.LiveIntercomMode.DoubleTalk);

2. Configure listeners.

   // Configure a listener for voice intercom events.
   IPCDev.getInstance().getIpcLiveIntercom().setOnLiveIntercomListener(MainActivity.this);
   // Configure a listener for callback errors in voice intercom.
   IPCDev.getInstance().getIpcLiveIntercom().setOnLiveIntercomErrorListener(MainActivity.this);

Sample code

You can use the following sample code to register an event listener and an error listener.

public interface OnLiveIntercomListener {

    /**
     * Receive a request from the app for starting voice intercom.
     *
     * @return: Return the format of upstream audio parameters used by the IP camera, such as the sample rate, number of channels, bit width, and audio format. Make sure that the app supports these audio parameter settings.
     */
    AudioParams onStartVoiceIntercom();

    /**
     * Receive the request to stop voice intercom.
     */
    void onStopVoiceIntercom();

    /**
     * Receive audio parameters from the app, which indicates that the channel with the app has been established and voice intercom can start.
     * @param audioParams: The audio parameters from the app.
     */
    void onAudioParamsChange(AudioParams audioParams);

    /**
     * Receive Pulse-Code Modulation (PCM) data from the app, which is often used for UI display, such as the volume.
     * @param buffer
     * @param size
     */
    void onAudioBufferReceive(byte[] buffer, int size);
}

public interface OnLiveIntercomErrorListener{

    /**
     * An error occurs in voice intercom.
     * @param error: See {@link LiveIntercomError}.
     */
    void onError(LiveIntercomError error);
}

Error codes