/// <summary>
/// Create a Router.
/// </summary>
public async Task <Router?> CreateRouterAsync(RouterOptions routerOptions)
{
if (_closed)
{
return(null);
}
await _closeLock.WaitAsync();
try
{
if (_closed)
{
return(null);
}
_logger.LogDebug("CreateRouterAsync()");
// This may throw.
var rtpCapabilities = ORTC.GenerateRouterRtpCapabilities(routerOptions.MediaCodecs);
var @internal = new { RouterId = Guid.NewGuid().ToString() };
await _channel.RequestAsync(MethodId.WORKER_CREATE_ROUTER, @internal);
var router = new Router(_loggerFactory, @internal.RouterId, rtpCapabilities, _channel, _payloadChannel, AppData);
lock (_routersLock)
{
_routers.Add(router);
}
router.On("@close", (_, _) =>
{
lock (_routersLock)
{
_routers.Remove(router);
}
return(Task.CompletedTask);
});
// Emit observer event.
Observer.Emit("newrouter", router);
return(router);
}
catch (Exception ex)
{
_logger.LogError(ex, "CreateRouterAsync()");
return(null);
}
finally
{
_closeLock.Set();
}
}
/// <summary>
/// Create a Consumer.
/// </summary>
/// <param name="consumerOptions"></param>
/// <returns></returns>
public virtual async Task <Consumer> ConsumeAsync(ConsumerOptions consumerOptions)
{
_logger.LogDebug($"ConsumeAsync() | Transport:{TransportId}");
if (consumerOptions.ProducerId.IsNullOrWhiteSpace())
{
throw new ArgumentException("missing producerId");
}
if (consumerOptions.RtpCapabilities == null)
{
throw new ArgumentException(nameof(consumerOptions.RtpCapabilities));
}
if (consumerOptions.Mid != null && consumerOptions.Mid.Length == 0)
{
throw new ArgumentException(nameof(consumerOptions.Mid));
}
if (!consumerOptions.Paused.HasValue)
{
consumerOptions.Paused = false;
}
// This may throw.
ORTC.ValidateRtpCapabilities(consumerOptions.RtpCapabilities);
var producer = GetProducerById(consumerOptions.ProducerId);
if (producer == null)
{
throw new NullReferenceException($"Producer with id {consumerOptions.ProducerId} not found");
}
var pipe = consumerOptions.Pipe.HasValue && consumerOptions.Pipe.Value;
// This may throw.
var rtpParameters = ORTC.GetConsumerRtpParameters(producer.ConsumableRtpParameters, consumerOptions.RtpCapabilities, pipe);
if (!pipe)
{
if (consumerOptions.Mid != null)
{
rtpParameters.Mid = consumerOptions.Mid;
}
else
{
lock (_nextMidForConsumersLock)
{
// Set MID.
rtpParameters.Mid = (_nextMidForConsumers++).ToString();
// We use up to 8 bytes for MID (string).
if (_nextMidForConsumers == 100_000_000)
{
_logger.LogDebug($"ConsumeAsync() | Reaching max MID value {_nextMidForConsumers}");
_nextMidForConsumers = 0;
}
}
}
}
var @internal = new ConsumerInternalData
(
Internal.RouterId,
Internal.TransportId,
consumerOptions.ProducerId,
Guid.NewGuid().ToString()
);
var reqData = new
{
producer.Kind,
RtpParameters = rtpParameters,
Type = pipe ? ProducerType.Pipe : producer.Type,
ConsumableRtpEncodings = producer.ConsumableRtpParameters.Encodings,
consumerOptions.Paused,
consumerOptions.PreferredLayers
};
var resData = await Channel.RequestAsync(MethodId.TRANSPORT_CONSUME, @internal, reqData);
var responseData = JsonSerializer.Deserialize <TransportConsumeResponseData>(resData !, ObjectExtensions.DefaultJsonSerializerOptions) !;
var data = new
{
producer.Kind,
RtpParameters = rtpParameters,
Type = (ConsumerType)(pipe ? ProducerType.Pipe : producer.Type), // 注意：类型转换。ProducerType 的每一种值在 ConsumerType 都有对应且相同的值。
};
var consumer = new Consumer(_loggerFactory,
@internal,
data.Kind,
data.RtpParameters,
data.Type,
Channel,
PayloadChannel,
AppData,
responseData.Paused,
responseData.ProducerPaused,
responseData.Score,
responseData.PreferredLayers);
consumer.On("@close", async(_, _) =>
{
await ConsumersLock.WaitAsync();
try
{
Consumers.Remove(consumer.ConsumerId);
}
catch (Exception ex)
{
_logger.LogError(ex, "@close");
}
finally
{
ConsumersLock.Set();
}
});
consumer.On("@producerclose", async(_, _) =>
{
await ConsumersLock.WaitAsync();
try
{
Consumers.Remove(consumer.ConsumerId);
}
catch (Exception ex)
{
_logger.LogError(ex, "@producerclose");
}
finally
{
ConsumersLock.Set();
}
});
await ConsumersLock.WaitAsync();
try
{
Consumers[consumer.ConsumerId] = consumer;
}
catch (Exception ex)
{
_logger.LogError(ex, "ConsumeAsync()");
}
finally
{
ConsumersLock.Set();
}
// Emit observer event.
Observer.Emit("newconsumer", consumer);
return(consumer);
}
/// <summary>
/// Create a Consumer.
/// </summary>
/// <param name="consumerOptions">注意：由于强类型的原因，这里使用的是 ConsumerOptions 类而不是 PipConsumerOptions 类</param>
/// <returns></returns>
public override async Task <Consumer> ConsumeAsync(ConsumerOptions consumerOptions)
{
_logger.LogDebug("ConsumeAsync()");
if (consumerOptions.ProducerId.IsNullOrWhiteSpace())
{
throw new Exception("missing producerId");
}
var producer = GetProducerById(consumerOptions.ProducerId);
if (producer == null)
{
throw new Exception($"Producer with id {consumerOptions.ProducerId} not found");
}
// This may throw.
var rtpParameters = ORTC.GetPipeConsumerRtpParameters(producer.ConsumableRtpParameters, Rtx);
var @internal = new ConsumerInternalData
(
Internal.RouterId,
Internal.TransportId,
consumerOptions.ProducerId,
Guid.NewGuid().ToString()
);
var reqData = new
{
producer.Kind,
RtpParameters = rtpParameters,
Type = ConsumerType.Pipe,
ConsumableRtpEncodings = producer.ConsumableRtpParameters.Encodings,
};
var resData = await Channel.RequestAsync(MethodId.TRANSPORT_CONSUME, @internal, reqData);
var responseData = JsonSerializer.Deserialize <TransportConsumeResponseData>(resData !, ObjectExtensions.DefaultJsonSerializerOptions) !;
var data = new
{
producer.Kind,
RtpParameters = rtpParameters,
Type = ConsumerType.Pipe,
};
// 在 Node.js 实现中， 创建 Consumer 对象时没提供 score 和 preferredLayers 参数，且 score = { score: 10, producerScore: 10 }。
var consumer = new Consumer(_loggerFactory,
@internal,
data.Kind,
data.RtpParameters,
data.Type,
Channel,
PayloadChannel,
AppData,
responseData.Paused,
responseData.ProducerPaused,
responseData.Score,
responseData.PreferredLayers);
consumer.On("@close", async(_, _) =>
{
await ConsumersLock.WaitAsync();
try
{
Consumers.Remove(consumer.ConsumerId);
}
catch (Exception ex)
{
_logger.LogError(ex, "@close");
}
finally
{
ConsumersLock.Set();
}
});
consumer.On("@producerclose", async(_, _) =>
{
await ConsumersLock.WaitAsync();
try
{
Consumers.Remove(consumer.ConsumerId);
}
catch (Exception ex)
{
_logger.LogError(ex, "@producerclose");
}
finally
{
ConsumersLock.Set();
}
});
await ConsumersLock.WaitAsync();
try
{
Consumers[consumer.ConsumerId] = consumer;
}
catch (Exception ex)
{
_logger.LogError(ex, "ConsumeAsync()");
}
finally
{
ConsumersLock.Set();
}
// Emit observer event.
Observer.Emit("newconsumer", consumer);
return(consumer);
}
/// <summary>
/// Create a Producer.
/// </summary>
public virtual async Task <Producer> ProduceAsync(ProducerOptions producerOptions)
{
_logger.LogDebug($"ProduceAsync() | Transport:{TransportId}");
if (!producerOptions.Id.IsNullOrWhiteSpace() && Producers.ContainsKey(producerOptions.Id !))
{
throw new Exception($"a Producer with same id \"{producerOptions.Id}\" already exists");
}
// This may throw.
ORTC.ValidateRtpParameters(producerOptions.RtpParameters);
// If missing or empty encodings, add one.
// 在 mediasoup-worker 中，要求 Encodings 至少要有一个元素。
if (producerOptions.RtpParameters.Encodings.IsNullOrEmpty())
{
producerOptions.RtpParameters.Encodings = new List <RtpEncodingParameters>
{
// 对 RtpEncodingParameters 序列化时，Rid、CodecPayloadType 和 Rtx 为 null 会忽略，因为客户端库对其有校验。
new RtpEncodingParameters()
};
}
// Don't do this in PipeTransports since there we must keep CNAME value in
// each Producer.
// TODO: (alby) 反模式
if (GetType() != typeof(PipeTransport))
{
// If CNAME is given and we don't have yet a CNAME for Producers in this
// Transport, take it.
if (_cnameForProducers.IsNullOrWhiteSpace() && producerOptions.RtpParameters.Rtcp != null && !producerOptions.RtpParameters.Rtcp.CNAME.IsNullOrWhiteSpace())
{
_cnameForProducers = producerOptions.RtpParameters.Rtcp.CNAME;
}
// Otherwise if we don't have yet a CNAME for Producers and the RTP parameters
// do not include CNAME, create a random one.
else if (_cnameForProducers.IsNullOrWhiteSpace())
{
_cnameForProducers = Guid.NewGuid().ToString().Substring(0, 8);
}
// Override Producer's CNAME.
// 对 RtcpParameters 序列化时，CNAME 和 ReducedSize 为 null 会忽略，因为客户端库对其有校验。
producerOptions.RtpParameters.Rtcp = producerOptions.RtpParameters.Rtcp ?? new RtcpParameters();
producerOptions.RtpParameters.Rtcp.CNAME = _cnameForProducers;
}
var routerRtpCapabilities = GetRouterRtpCapabilities();
// This may throw.
var rtpMapping = ORTC.GetProducerRtpParametersMapping(producerOptions.RtpParameters, routerRtpCapabilities);
// This may throw.
var consumableRtpParameters = ORTC.GetConsumableRtpParameters(producerOptions.Kind, producerOptions.RtpParameters, routerRtpCapabilities, rtpMapping);
var @internal = new ProducerInternalData
(
Internal.RouterId,
Internal.TransportId,
producerOptions.Id.NullOrWhiteSpaceReplace(Guid.NewGuid().ToString())
);
var reqData = new
{
producerOptions.Kind,
producerOptions.RtpParameters,
RtpMapping = rtpMapping,
producerOptions.KeyFrameRequestDelay,
producerOptions.Paused,
};
var resData = await Channel.RequestAsync(MethodId.TRANSPORT_PRODUCE, @internal, reqData);
var responseData = JsonSerializer.Deserialize <TransportProduceResponseData>(resData !, ObjectExtensions.DefaultJsonSerializerOptions) !;
var data = new
{
producerOptions.Kind,
producerOptions.RtpParameters,
responseData.Type,
ConsumableRtpParameters = consumableRtpParameters
};
var producer = new Producer(_loggerFactory,
@internal,
data.Kind,
data.RtpParameters,
data.Type,
data.ConsumableRtpParameters,
Channel,
PayloadChannel,
producerOptions.AppData,
producerOptions.Paused !.Value);
producer.On("@close", async(_, _) =>
{
await ProducersLock.WaitAsync();
try
{
Producers.Remove(producer.ProducerId);
Emit("@producerclose", producer);
}
catch (Exception ex)
{
_logger.LogError(ex, "@close");
}
finally
{
ProducersLock.Set();
}
});
await ProducersLock.WaitAsync();
try
{
Producers[producer.ProducerId] = producer;
}
catch (Exception ex)
{
_logger.LogError(ex, "ProduceAsync()");
}
finally
{
ProducersLock.Set();
}
Emit("@newproducer", producer);
// Emit observer event.
Observer.Emit("newproducer", producer);
return(producer);
}