0e61fdd27c
Bug: webrtc:12338 Change-Id: Ib97b2c3d64dbd895f261ffa76a2e885bd934a87f Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/226940 Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Artem Titov <titovartem@webrtc.org> Cr-Commit-Position: refs/heads/master@{#34554}
75 lines
2.4 KiB
C++
75 lines
2.4 KiB
C++
/*
|
|
* Copyright (c) 2020 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef API_VOIP_VOIP_DTMF_H_
|
|
#define API_VOIP_VOIP_DTMF_H_
|
|
|
|
#include "api/voip/voip_base.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// DTMF events and their event codes as defined in
|
|
// https://tools.ietf.org/html/rfc4733#section-7
|
|
enum class DtmfEvent : uint8_t {
|
|
kDigitZero = 0,
|
|
kDigitOne,
|
|
kDigitTwo,
|
|
kDigitThree,
|
|
kDigitFour,
|
|
kDigitFive,
|
|
kDigitSix,
|
|
kDigitSeven,
|
|
kDigitEight,
|
|
kDigitNine,
|
|
kAsterisk,
|
|
kHash,
|
|
kLetterA,
|
|
kLetterB,
|
|
kLetterC,
|
|
kLetterD
|
|
};
|
|
|
|
// VoipDtmf interface provides DTMF related interfaces such
|
|
// as sending DTMF events to the remote endpoint.
|
|
class VoipDtmf {
|
|
public:
|
|
// Register the payload type and sample rate for DTMF (RFC 4733) payload.
|
|
// Must be called exactly once prior to calling SendDtmfEvent after payload
|
|
// type has been negotiated with remote.
|
|
// Returns following VoipResult;
|
|
// kOk - telephone event type is registered as provided.
|
|
// kInvalidArgument - `channel_id` is invalid.
|
|
virtual VoipResult RegisterTelephoneEventType(ChannelId channel_id,
|
|
int rtp_payload_type,
|
|
int sample_rate_hz) = 0;
|
|
|
|
// Send DTMF named event as specified by
|
|
// https://tools.ietf.org/html/rfc4733#section-3.2
|
|
// `duration_ms` specifies the duration of DTMF packets that will be emitted
|
|
// in place of real RTP packets instead.
|
|
// Must be called after RegisterTelephoneEventType and VoipBase::StartSend
|
|
// have been called.
|
|
// Returns following VoipResult;
|
|
// kOk - requested DTMF event is successfully scheduled.
|
|
// kInvalidArgument - `channel_id` is invalid.
|
|
// kFailedPrecondition - Missing prerequisite on RegisterTelephoneEventType
|
|
// or sending state.
|
|
virtual VoipResult SendDtmfEvent(ChannelId channel_id,
|
|
DtmfEvent dtmf_event,
|
|
int duration_ms) = 0;
|
|
|
|
protected:
|
|
virtual ~VoipDtmf() = default;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // API_VOIP_VOIP_DTMF_H_
|