Implement turns

Author: Paulo Morgado

.editorconfig

@@ -24,4 +24,28 @@ csharp_preserve_single_line_statements = true
 csharp_preserve_single_line_blocks = true
 
 # Don't allow single line if/else blocks without braces.
-csharp_prefer_braces = true:error 
+csharp_prefer_braces = true:error
+
+# IDE0007: Use implicit type
+dotnet_diagnostic.IDE0007.severity = suggestion
+
+# IDE0019: Use pattern matching
+dotnet_diagnostic.IDE0019.severity = suggestion
+
+# IDE0030: Use coalesce expression
+dotnet_diagnostic.IDE0030.severity = suggestion
+
+# IDE0031: Use null propagation
+dotnet_diagnostic.IDE0031.severity = suggestion
+
+# IDE0078: Use pattern matching
+dotnet_diagnostic.IDE0078.severity = suggestion
+
+# IDE0083: Use pattern matching
+dotnet_diagnostic.IDE0083.severity = suggestion
+
+# Default severity for analyzer diagnostics with category 'Performance'
+dotnet_analyzer_diagnostic.category-Style.severity = suggestion
+
+# Default severity for analyzer diagnostics with category 'Style'
+dotnet_analyzer_diagnostic.category-Performance.severity = suggestion

SIPSorceryMedia.Abstractions/LICENSE

@@ -0,0 +1,32 @@
+# License
+
+## 1. BSD 3-Clause "New" or "Revised" License
+
+Copyright (c) 2020–2025 Aaron Clauson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+3. Neither the name “SIP Sorcery,” nor “Aaron Clauson,” nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+## 2. Additional Restriction: Boycott, Divestment, Sanctions (BDS) – Attribution-NonCommercial-ShareAlike
+
+**Boycott Divestment Sanctions – Attribution-NonCommercial-ShareAlike (BDS BY-NC-SA)**
+
+This software **must not be used** to further the Apartheid policies of Israel. Use, modification, or distribution **inside** Israel and the Occupied Territories is strictly forbidden until the demands of the Boycott, Divestment and Sanctions movement have been met:
+
+* Israel has ended the occupation and colonization of all Arab lands occupied in 1967 and dismantled the Wall;
+* Arab-Palestinian citizens of Israel have been granted full equality; and
+* Palestinian refugees have obtained the right to return to their homes and properties as stipulated in UN Resolution 194.
+
+For all other geographic regions **outside** of Israel and the Occupied Territories, use, modification, and distribution are permitted under the terms of the **BSD 3-Clause "New" or "Revised" License** above (Section 1), provided that any future use, modification, or distribution carries the above BDS restriction and abides by the ShareAlike and NonCommercial principles.
+
+This restriction is **not** intended to limit the rights of Israelis or any other people residing outside of Israel and the Occupied Territories.
+
+In any instance where the BSD 3-Clause License conflicts with the above restriction, the above restriction shall be interpreted as superior, and all other non-conflicting provisions of the BSD 3-Clause license shall remain in effect.

SIPSorceryMedia.Abstractions/README.md

@@ -0,0 +1,22 @@
+# SIPSorceryMedia.Abstractions
+
+This project provides the logic for the interfaces required by the [SIPSorcery](https://github.com/sipsorcery-org/sipsorcery) real-time communications library and the components that provide functions such as:
+
+ - Access to audio or video devices (example [SIPSorceryMedia.Windows](https://github.com/sipsorcery-org/SIPSorceryMedia.Windows)).
+ - Access to codecs from native libraries (examples [SIPSorceryMedia.Encoders](https://github.com/sipsorcery-org/SIPSorceryMedia.Encoders) and [SIPSorceryMedia.FFmpeg](https://github.com/sipsorcery-org/SIPSorceryMedia.FFmpeg)).
+
+# Important Interfaces
+
+The most important interfacs contained in this library are:
+
+  - IAudioEncoder: Needs to be implemented by classes that provide audio decoding and/or encoding. An example is the [AudioEncoder](https://github.com/sipsorcery-org/sipsorcery/blob/master/src/app/Media/Codecs/AudioEncoder.cs) class.
+ 
+  - IVideoEncoder: Needs to be implemented by classes that provide video decoding and/or encoding. An example is the [VpxVideoEncoder](https://github.com/sipsorcery-org/SIPSorceryMedia.Encoders/blob/master/src/VpxVideoEncoder.cs#L25) class.
+  
+  - IAudioSource: Needs to be implemented by classes that act as a source of raw audio samples. Typically a microphone. An example is the [WindowsAudioEndPoint](https://github.com/sipsorcery-org/SIPSorceryMedia.Windows/blob/master/src/WindowsAudioEndPoint.cs#L32) class.
+  
+  - IAudioSink: Needs to be implemented by classes that act as a sink for raw audio samples. Typically an audio speaker. An example is the [WindowsAudioEndPoint](https://github.com/sipsorcery-org/SIPSorceryMedia.Windows/blob/master/src/WindowsAudioEndPoint.cs#L32) class.
+   
+  - IVideoSource: Needs to be implemented by classes that act as a source of raw video frames. Typically a webcam. An examples is the [WindowsVideoEndPoint](https://github.com/sipsorcery-org/SIPSorceryMedia.Windows/blob/master/src/WindowsVideoEndPoint.cs#L48).
+  
+  - IVideoSink: Needs to be implemented by classes that act as a sink for raw video frames. The video sink is usually a bitmap or some kind of graphics surface. An examples is the [WindowsVideoEndPoint](https://github.com/sipsorcery-org/SIPSorceryMedia.Windows/blob/master/src/WindowsVideoEndPoint.cs#L48).

SIPSorceryMedia.Abstractions/src/Encoders/IAudioEncoder.cs

@@ -0,0 +1,45 @@
+//-----------------------------------------------------------------------------
+// Filename: IAudioEncoder.cs
+//
+// Description: Common interface for an audio codec.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+using System;
+using System.Buffers;
+using System.Collections.Generic;
+
+namespace SIPSorceryMedia.Abstractions;
+
+public interface IAudioEncoder
+{
+    /// <summary>
+    /// Needs to be set with the list of audio formats that the encoder supports.
+    /// </summary>
+    List<AudioFormat> SupportedFormats { get; }
+
+    /// <summary>
+    /// Encodes 16bit signed PCM samples.
+    /// </summary>
+    /// <param name="pcm">An array of 16 bit signed audio samples.</param>
+    /// <param name="format">The audio format to encode the PCM sample to.</param>
+    /// <param name="destination">A <see cref="IBufferWriter{T}"/> of <see langword="byte"/> to receieve the encoded sample.</param>
+    void EncodeAudio(ReadOnlySpan<short> pcm, AudioFormat format, IBufferWriter<byte> destination);
+
+    /// <summary>
+    /// Decodes to 16bit signed PCM samples.
+    /// </summary>
+    /// <param name="encodedSample">The span containing the encoded sample.</param>
+    /// <param name="format">The audio format of the encoded sample.</param>
+    /// <param name="destination">A <see cref="IBufferWriter{T}"/> of <see langword="short"/> to receive the decoded PCM samples.</param>
+    void DecodeAudio(ReadOnlySpan<byte> encodedSample, AudioFormat format, IBufferWriter<short> destination);
+}

SIPSorceryMedia.Abstractions/src/Encoders/ITextEncoder.cs

@@ -0,0 +1,36 @@
+//-----------------------------------------------------------------------------
+// Filename: ITextEncoder.cs
+//
+// Description: Common interface for a text codec.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+namespace SIPSorceryMedia.Abstractions;
+
+public interface ITextEncoder
+{
+    /// <summary>
+    /// Encode a text into a byte array.
+    /// </summary>
+    /// <param name="text">A symbol or text to be transmitted</param>
+    /// <param name="format">The text format of the sample.</param>
+    /// <returns>A byte array containing the encoded text sample</returns>
+    byte[] EncodeText(char[] text, TextFormat format);
+
+    /// <summary>
+    /// Decode a byte array into a string type text.
+    /// </summary>
+    /// <param name="encodedSample">A symbol or text that was received</param>
+    /// <param name="format">The text format of the sample.</param>
+    /// <returns></returns>
+    char[] DecodeText(byte[] encodedSample, TextFormat format);
+}

SIPSorceryMedia.Abstractions/src/Encoders/IVideoEncoder.cs

@@ -0,0 +1,38 @@
+//-----------------------------------------------------------------------------
+// Filename: IVideoEncoder.cs
+//
+// Description: Common interface for a video codec.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+using System;
+using System.Collections.Generic;
+
+namespace SIPSorceryMedia.Abstractions;
+
+public interface IVideoEncoder : IDisposable
+{
+    /// <summary>
+    /// Needs to be set with the list of video formats that the encoder supports.
+    /// </summary>
+    List<VideoFormat> SupportedFormats { get; }
+
+    byte[] EncodeVideo(int width, int height, byte[] sample, VideoPixelFormatsEnum pixelFormat, VideoCodecsEnum codec);
+
+    byte[] EncodeVideoFaster(RawImage rawImage, VideoCodecsEnum codec); // Avoid to use byte[] to improve performance
+
+    void ForceKeyFrame();
+
+    IEnumerable<VideoSample> DecodeVideo(byte[] encodedSample, VideoPixelFormatsEnum pixelFormat, VideoCodecsEnum codec);
+
+    IEnumerable<RawImage> DecodeVideoFaster(byte[] encodedSample, VideoPixelFormatsEnum pixelFormat, VideoCodecsEnum codec); // Avoid to use byte[] to improve performance
+}

SIPSorceryMedia.Abstractions/src/Encoders/RawImage.cs

@@ -0,0 +1,68 @@
+//-----------------------------------------------------------------------------
+// Filename: RawImage.cs
+//
+// Description: A raw image for use with a video codec.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+using System;
+using System.Runtime.InteropServices;
+
+namespace SIPSorceryMedia.Abstractions;
+
+public class RawImage
+{
+    /// <summary>
+    /// The width, in pixels, of the image
+    /// </summary>
+    public int Width { get; set; }
+
+    /// <summary>
+    /// The height, in pixels, of the image
+    /// </summary>
+    public int Height { get; set; }
+
+    /// <summary>
+    /// Integer that specifies the byte offset between the beginning of one scan line and the next.
+    /// </summary>
+    public int Stride { get; set; }
+
+    /// <summary>
+    /// Pointer to an array of bytes that contains the pixel data.
+    /// </summary>
+    public nint Sample { get; set; }
+
+    /// <summary>
+    /// The pixel format of the image
+    /// </summary>
+    public VideoPixelFormatsEnum PixelFormat { get; set; }
+
+    /// <summary>
+    /// Get bytes array of the image.
+    /// 
+    /// For performance reasons it's better to use directly Sample
+    /// </summary>
+    /// <returns></returns>
+    public byte[] GetBuffer()
+    {
+        byte[] result = null;
+
+        if ((Height > 0) && (Stride > 0))
+        {
+            var bufferSize = Height * Stride;
+
+            result = new byte[bufferSize];
+            Marshal.Copy(Sample, result, 0, bufferSize);
+        }
+        return result;
+    }
+}

SIPSorceryMedia.Abstractions/src/Encoders/VideoSample.cs

@@ -0,0 +1,24 @@
+//-----------------------------------------------------------------------------
+// Filename: VideoSample.cs
+//
+// Description: Representation of an unencoded video sample.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+namespace SIPSorceryMedia.Abstractions;
+
+public struct VideoSample
+{
+    public uint Width;
+    public uint Height;
+    public byte[] Sample;
+}

SIPSorceryMedia.Abstractions/src/EnumExtensions.cs

@@ -0,0 +1,6 @@
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.AudioSamplingRatesEnum>()]
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.VideoPixelFormatsEnum>()]
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.SDPWellKnownMediaFormatsEnum>()]
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.AudioCodecsEnum>()]
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.VideoCodecsEnum>()]
+[assembly: global::NetEscapades.EnumGenerators.EnumExtensions<global::SIPSorceryMedia.Abstractions.TextCodecsEnum>()]

SIPSorceryMedia.Abstractions/src/Enums/AudioCodecsEnum.cs

@@ -0,0 +1,39 @@
+//-----------------------------------------------------------------------------
+// Filename: AudioCodecsEnum.cs
+//
+// Description: Enum for common audio codecs.
+//
+// Author(s):
+// Aaron Clauson ([email protected])
+// 
+// History:
+// 20 May 2025  Aaron Clauson   Refactored from MediaEndPoints.
+//
+// License: 
+// BSD 3-Clause "New" or "Revised" License and the additional
+// BDS BY-NC-SA restriction, see included LICENSE.md file.
+//-----------------------------------------------------------------------------
+
+namespace SIPSorceryMedia.Abstractions;
+
+public enum AudioCodecsEnum
+{
+    Unknown,
+
+    PCMU,
+    GSM,
+    G723,
+    DVI4,
+    LPC,
+    PCMA,
+    G722,
+    L16,
+    QCELP,
+    CN,
+    MPA,
+    G728,
+    G729,
+    OPUS,
+
+    PCM_S16LE,  // PCM signed 16-bit little-endian (equivalent to FFmpeg s16le). For use with Azure, not likely to be supported in VoIP/WebRTC.
+}