summaryrefslogtreecommitdiff
path: root/pjmedia/src/pjmedia/session.c
diff options
context:
space:
mode:
Diffstat (limited to 'pjmedia/src/pjmedia/session.c')
-rw-r--r--pjmedia/src/pjmedia/session.c444
1 files changed, 444 insertions, 0 deletions
diff --git a/pjmedia/src/pjmedia/session.c b/pjmedia/src/pjmedia/session.c
new file mode 100644
index 0000000..f98bafc
--- /dev/null
+++ b/pjmedia/src/pjmedia/session.c
@@ -0,0 +1,444 @@
+/* $Id: session.c 3841 2011-10-24 09:28:13Z ming $ */
+/*
+ * Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com)
+ * Copyright (C) 2003-2008 Benny Prijono <benny@prijono.org>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ */
+#include <pjmedia/session.h>
+#include <pjmedia/errno.h>
+#include <pj/log.h>
+#include <pj/os.h>
+#include <pj/pool.h>
+#include <pj/string.h>
+#include <pj/assert.h>
+#include <pj/ctype.h>
+#include <pj/rand.h>
+
+
+struct pjmedia_session
+{
+ pj_pool_t *pool;
+ pjmedia_endpt *endpt;
+ unsigned stream_cnt;
+ pjmedia_stream_info stream_info[PJMEDIA_MAX_SDP_MEDIA];
+ pjmedia_stream *stream[PJMEDIA_MAX_SDP_MEDIA];
+ void *user_data;
+};
+
+#define THIS_FILE "session.c"
+
+#ifndef PJMEDIA_SESSION_SIZE
+# define PJMEDIA_SESSION_SIZE (10*1024)
+#endif
+
+#ifndef PJMEDIA_SESSION_INC
+# define PJMEDIA_SESSION_INC 1024
+#endif
+
+
+static const pj_str_t ID_AUDIO = { "audio", 5};
+static const pj_str_t ID_VIDEO = { "video", 5};
+static const pj_str_t ID_APPLICATION = { "application", 11};
+static const pj_str_t ID_IN = { "IN", 2 };
+static const pj_str_t ID_IP4 = { "IP4", 3};
+static const pj_str_t ID_IP6 = { "IP6", 3};
+static const pj_str_t ID_RTP_AVP = { "RTP/AVP", 7 };
+static const pj_str_t ID_RTP_SAVP = { "RTP/SAVP", 8 };
+//static const pj_str_t ID_SDP_NAME = { "pjmedia", 7 };
+static const pj_str_t ID_RTPMAP = { "rtpmap", 6 };
+static const pj_str_t ID_TELEPHONE_EVENT = { "telephone-event", 15 };
+
+static const pj_str_t STR_INACTIVE = { "inactive", 8 };
+static const pj_str_t STR_SENDRECV = { "sendrecv", 8 };
+static const pj_str_t STR_SENDONLY = { "sendonly", 8 };
+static const pj_str_t STR_RECVONLY = { "recvonly", 8 };
+
+/*
+ * Initialize session info from SDP session descriptors.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_info_from_sdp( pj_pool_t *pool,
+ pjmedia_endpt *endpt,
+ unsigned max_streams,
+ pjmedia_session_info *si,
+ const pjmedia_sdp_session *local,
+ const pjmedia_sdp_session *remote)
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(pool && endpt && si && local && remote, PJ_EINVAL);
+
+ si->stream_cnt = max_streams;
+ if (si->stream_cnt > local->media_count)
+ si->stream_cnt = local->media_count;
+
+ for (i=0; i<si->stream_cnt; ++i) {
+ pj_status_t status;
+
+ status = pjmedia_stream_info_from_sdp( &si->stream_info[i], pool,
+ endpt,
+ local, remote, i);
+ if (status != PJ_SUCCESS)
+ return status;
+ }
+
+ return PJ_SUCCESS;
+}
+
+
+/**
+ * Create new session.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_create( pjmedia_endpt *endpt,
+ const pjmedia_session_info *si,
+ pjmedia_transport *transports[],
+ void *user_data,
+ pjmedia_session **p_session )
+{
+ pj_pool_t *pool;
+ pjmedia_session *session;
+ int i; /* Must be signed */
+ pj_status_t status;
+
+ /* Verify arguments. */
+ PJ_ASSERT_RETURN(endpt && si && p_session, PJ_EINVAL);
+
+ /* Create pool for the session. */
+ pool = pjmedia_endpt_create_pool( endpt, "session",
+ PJMEDIA_SESSION_SIZE,
+ PJMEDIA_SESSION_INC);
+ PJ_ASSERT_RETURN(pool != NULL, PJ_ENOMEM);
+
+ session = PJ_POOL_ZALLOC_T(pool, pjmedia_session);
+ session->pool = pool;
+ session->endpt = endpt;
+ session->stream_cnt = si->stream_cnt;
+ session->user_data = user_data;
+
+ /* Copy stream info (this simple memcpy may break sometime) */
+ pj_memcpy(session->stream_info, si->stream_info,
+ si->stream_cnt * sizeof(pjmedia_stream_info));
+
+ /*
+ * Now create and start the stream!
+ */
+ for (i=0; i<(int)si->stream_cnt; ++i) {
+
+ /* Create the stream */
+ status = pjmedia_stream_create(endpt, session->pool,
+ &session->stream_info[i],
+ (transports?transports[i]:NULL),
+ session,
+ &session->stream[i]);
+ if (status == PJ_SUCCESS)
+ status = pjmedia_stream_start(session->stream[i]);
+
+ if (status != PJ_SUCCESS) {
+
+ for ( --i; i>=0; ++i) {
+ pjmedia_stream_destroy(session->stream[i]);
+ }
+
+ pj_pool_release(session->pool);
+ return status;
+ }
+ }
+
+
+ /* Done. */
+
+ *p_session = session;
+ return PJ_SUCCESS;
+}
+
+
+/*
+ * Get session info.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_get_info( pjmedia_session *session,
+ pjmedia_session_info *info )
+{
+ PJ_ASSERT_RETURN(session && info, PJ_EINVAL);
+
+ info->stream_cnt = session->stream_cnt;
+ pj_memcpy(info->stream_info, session->stream_info,
+ session->stream_cnt * sizeof(pjmedia_stream_info));
+
+ return PJ_SUCCESS;
+}
+
+/*
+ * Get user data.
+ */
+PJ_DEF(void*) pjmedia_session_get_user_data( pjmedia_session *session)
+{
+ return (session? session->user_data : NULL);
+}
+
+/**
+ * Destroy media session.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_destroy (pjmedia_session *session)
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+
+ for (i=0; i<session->stream_cnt; ++i) {
+
+ pjmedia_stream_destroy(session->stream[i]);
+
+ }
+
+ pj_pool_release (session->pool);
+
+ return PJ_SUCCESS;
+}
+
+
+/**
+ * Activate all stream in media session.
+ *
+ */
+PJ_DEF(pj_status_t) pjmedia_session_resume(pjmedia_session *session,
+ pjmedia_dir dir)
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+
+ for (i=0; i<session->stream_cnt; ++i) {
+ pjmedia_session_resume_stream(session, i, dir);
+ }
+
+ return PJ_SUCCESS;
+}
+
+
+/**
+ * Suspend receipt and transmission of all stream in media session.
+ *
+ */
+PJ_DEF(pj_status_t) pjmedia_session_pause(pjmedia_session *session,
+ pjmedia_dir dir)
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+
+ for (i=0; i<session->stream_cnt; ++i) {
+ pjmedia_session_pause_stream(session, i, dir);
+ }
+
+ return PJ_SUCCESS;
+}
+
+
+/**
+ * Suspend receipt and transmission of individual stream in media session.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_pause_stream( pjmedia_session *session,
+ unsigned index,
+ pjmedia_dir dir)
+{
+ PJ_ASSERT_RETURN(session && index < session->stream_cnt, PJ_EINVAL);
+
+ return pjmedia_stream_pause(session->stream[index], dir);
+}
+
+
+/**
+ * Activate individual stream in media session.
+ *
+ */
+PJ_DEF(pj_status_t) pjmedia_session_resume_stream( pjmedia_session *session,
+ unsigned index,
+ pjmedia_dir dir)
+{
+ PJ_ASSERT_RETURN(session && index < session->stream_cnt, PJ_EINVAL);
+
+ return pjmedia_stream_resume(session->stream[index], dir);
+}
+
+/**
+ * Send RTCP SDES for the session.
+ */
+PJ_DEF(pj_status_t)
+pjmedia_session_send_rtcp_sdes( const pjmedia_session *session )
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+
+ for (i=0; i<session->stream_cnt; ++i) {
+ pjmedia_stream_send_rtcp_sdes(session->stream[i]);
+ }
+
+ return PJ_SUCCESS;
+}
+
+/**
+ * Send RTCP BYE for the session.
+ */
+PJ_DEF(pj_status_t)
+pjmedia_session_send_rtcp_bye( const pjmedia_session *session )
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+
+ for (i=0; i<session->stream_cnt; ++i) {
+ pjmedia_stream_send_rtcp_bye(session->stream[i]);
+ }
+
+ return PJ_SUCCESS;
+}
+
+/**
+ * Enumerate media stream in the session.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_enum_streams(const pjmedia_session *session,
+ unsigned *count,
+ pjmedia_stream_info info[])
+{
+ unsigned i;
+
+ PJ_ASSERT_RETURN(session && count && *count && info, PJ_EINVAL);
+
+ if (*count > session->stream_cnt)
+ *count = session->stream_cnt;
+
+ for (i=0; i<*count; ++i) {
+ pj_memcpy(&info[i], &session->stream_info[i],
+ sizeof(pjmedia_stream_info));
+ }
+
+ return PJ_SUCCESS;
+}
+
+
+/*
+ * Get the port interface.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_get_port( pjmedia_session *session,
+ unsigned index,
+ pjmedia_port **p_port)
+{
+ return pjmedia_stream_get_port( session->stream[index], p_port);
+}
+
+/*
+ * Get statistics
+ */
+PJ_DEF(pj_status_t) pjmedia_session_get_stream_stat( pjmedia_session *session,
+ unsigned index,
+ pjmedia_rtcp_stat *stat)
+{
+ PJ_ASSERT_RETURN(session && stat && index < session->stream_cnt,
+ PJ_EINVAL);
+
+ return pjmedia_stream_get_stat(session->stream[index], stat);
+}
+
+
+/**
+ * Reset session statistics.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_reset_stream_stat( pjmedia_session *session,
+ unsigned index)
+{
+ PJ_ASSERT_RETURN(session && index < session->stream_cnt, PJ_EINVAL);
+
+ return pjmedia_stream_reset_stat(session->stream[index]);
+}
+
+
+#if defined(PJMEDIA_HAS_RTCP_XR) && (PJMEDIA_HAS_RTCP_XR != 0)
+/*
+ * Get extended statistics
+ */
+PJ_DEF(pj_status_t) pjmedia_session_get_stream_stat_xr(
+ pjmedia_session *session,
+ unsigned index,
+ pjmedia_rtcp_xr_stat *stat_xr)
+{
+ PJ_ASSERT_RETURN(session && stat_xr && index < session->stream_cnt,
+ PJ_EINVAL);
+
+ return pjmedia_stream_get_stat_xr(session->stream[index], stat_xr);
+}
+#endif
+
+PJ_DEF(pj_status_t) pjmedia_session_get_stream_stat_jbuf(
+ pjmedia_session *session,
+ unsigned index,
+ pjmedia_jb_state *state)
+{
+ PJ_ASSERT_RETURN(session && state && index < session->stream_cnt,
+ PJ_EINVAL);
+
+ return pjmedia_stream_get_stat_jbuf(session->stream[index], state);
+}
+
+/*
+ * Dial DTMF digit to the stream, using RFC 2833 mechanism.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_dial_dtmf( pjmedia_session *session,
+ unsigned index,
+ const pj_str_t *ascii_digits )
+{
+ PJ_ASSERT_RETURN(session && ascii_digits, PJ_EINVAL);
+ return pjmedia_stream_dial_dtmf(session->stream[index], ascii_digits);
+}
+
+/*
+ * Check if the specified stream has received DTMF digits.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_check_dtmf( pjmedia_session *session,
+ unsigned index )
+{
+ PJ_ASSERT_RETURN(session, PJ_EINVAL);
+ return pjmedia_stream_check_dtmf(session->stream[index]);
+}
+
+
+/*
+ * Retrieve DTMF digits from the specified stream.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_get_dtmf( pjmedia_session *session,
+ unsigned index,
+ char *ascii_digits,
+ unsigned *size )
+{
+ PJ_ASSERT_RETURN(session && ascii_digits && size, PJ_EINVAL);
+ return pjmedia_stream_get_dtmf(session->stream[index], ascii_digits,
+ size);
+}
+
+/*
+ * Install DTMF callback.
+ */
+PJ_DEF(pj_status_t) pjmedia_session_set_dtmf_callback(pjmedia_session *session,
+ unsigned index,
+ void (*cb)(pjmedia_stream*,
+ void *user_data,
+ int digit),
+ void *user_data)
+{
+ PJ_ASSERT_RETURN(session && index < session->stream_cnt, PJ_EINVAL);
+ return pjmedia_stream_set_dtmf_callback(session->stream[index], cb,
+ user_data);
+}
+
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-25 23:03:57 +0000