spice协议----播放和录音通道

1  播放通道定义

SPICE协议支持服务器发送音频流数据在客户端播放。音频流服务器使用SPICE_MSG_PLAYBACK_DATA消息发送客户端，音频数据的内容有播放模式控制（服务器通过SPICE_MSG_PLAYBACK_MODE消息发送客户端）。服务器通过发送SPICE_MSG_PLAYBACK_START消息和SPICE_MSG_PLAYBACK_STOP消息来停止和播放音频流。数据包发送期间只允许停止和播放消息。

1.1服务器—》客户端消息宏

enum {

    SPICE_MSG_PLAYBACK_DATA = 101,

    SPICE_MSG_PLAYBACK_MODE,

    SPICE_MSG_PLAYBACK_START,

    SPICE_MSG_PLAYBACK_STOP,

    SPICE_MSG_PLAYBACK_VOLUME,

    SPICE_MSG_PLAYBACK_MUTE,

    SPICE_MSG_PLAYBACK_LATENCY,

 

    SPICE_MSG_END_PLAYBACK

};

1.2音频模式

typedef enumSpiceAudioFmt {

    SPICE_AUDIO_FMT_INVALID,

   SPICE_AUDIO_FMT_S16,

    SPICE_AUDIO_FMT_ENUM_END

}SpiceAudioFmt;

1.3音频包播放模式

typedef enumSpiceAudioDataMode {

    SPICE_AUDIO_DATA_MODE_INVALID,

    SPICE_AUDIO_DATA_MODE_RAW,

    SPICE_AUDIO_DATA_MODE_CELT_0_5_1,

    SPICE_AUDIO_DATA_MODE_OPUS,

 

    SPICE_AUDIO_DATA_MODE_ENUM_END

}SpiceAudioDataMode;

1.4音频播放通道能力

SPICE客户机需要声明支持CELT_5_1通道功能,以允许服务器发送播放CELT_0_5_1格式的数据包。这个应该在通道建立的时候会有能力协商吧?

 

1.5SpiceMsgPlaybackStart结构体描述

typedef struct SpiceMsgPlaybackStart {

   uint32_t channels;

   uint32_t format; //SPICE_AUDIO_FMT_?

   uint32_t frequency;

   uint32_t time;

} SpiceMsgPlaybackStart;

 

2  录音通道定义

SPICE协议支持音频流捕捉从客户端发送到服务器。SPCIE服务器发送SPICE_MSG_RECORD_START通知客户端开始发送音频数据。客户端回应开始发送开始标记时间戳（REDC_RECORD_START_MARK）客户端发送完开始标记后使用SPICE_MSGC_RECORD_DATA。为了通知服务器使用什么样的类型发送数据，在发送时间戳之前必须发送SPICE_MSGC_RECORD_MODE消息。服务器发送SPICE_MSG_RECORD_STOP消息通知客户端停止。

2.1服务器—》客户端

enum {

    SPICE_MSG_RECORD_START = 101,

    SPICE_MSG_RECORD_STOP,

    SPICE_MSG_RECORD_VOLUME,

    SPICE_MSG_RECORD_MUTE,

 

    SPICE_MSG_END_RECORD

};

2.2客户端—》服务器

enum {

    SPICE_MSGC_RECORD_DATA = 101,

    SPICE_MSGC_RECORD_MODE,

    SPICE_MSGC_RECORD_START_MARK,

 

    SPICE_MSGC_END_RECORD

};

2.3音频格式

typedef enumSpiceAudioFmt {

    SPICE_AUDIO_FMT_INVALID,

    SPICE_AUDIO_FMT_S16,

    SPICE_AUDIO_FMT_ENUM_END

} SpiceAudioFmt;

2.4录音数据模式

两种类型的数据模式可供选择：

1）  原始数据PCM数据RAW格式

2）  压缩数据Celti_0_5_1格式

typedef enumSpiceAudioDataMode {

    SPICE_AUDIO_DATA_MODE_INVALID,

    SPICE_AUDIO_DATA_MODE_RAW,

    SPICE_AUDIO_DATA_MODE_CELT_0_5_1,

    SPICE_AUDIO_DATA_MODE_OPUS,

    SPICE_AUDIO_DATA_MODE_ENUM_END

}SpiceAudioDataMode;

2.5录音通道能力

SPICE服务器需要声明支持CELT_5_1通道功能,以允许客户端发送记录CELT_0_5_1格式的数据包。

enum {

    SPICE_RECORD_CAP_CELT_0_5_1,

    SPICE_RECORD_CAP_VOLUME,

    SPICE_RECORD_CAP_OPUS,

};

2.6SpiceMsgcRecordMode结构体

typedef structSpiceMsgPlaybackMode {

    uint32_t time; //客户端时间戳

    uint32_t mode; //SPICE_AUDIO_DATA_MODE_?

    uint8_t *data;//数据

    uint32_t data_size;.// 数据大小

} SpiceMsgPlaybackMode,SpiceMsgcRecordMode;

2.7SpiceMsgRecordStart结构体描述

typedef structSpiceMsgRecordStart {

    uint32_t channels;

    uint32_t format; //SPICE_AUDIO_FMT_?

    uint32_t frequency;

}SpiceMsgRecordStart;

2.8SpiceMsgcRecordStartMark结构体描述

typedef structSpiceMsgcRecordStartMark {

    uint32_t time; //音频流开始时间戳

}SpiceMsgcRecordStartMark;

2.9SpiceMsgcRecordPacket结构体描述

typedef structSpiceMsgPlaybackPacket {

    uint32_t time; //时间戳

    uint8_t *data;

    uint32_t data_size;

}SpiceMsgPlaybackPacket, SpiceMsgcRecordPacket;