/// <summary>
/// Creates a <see cref="SpeechClient"/> which uses the specified channel for remote operations.
/// </summary>
/// <param name="channel">The <see cref="Channel"/> for remote operations. Must not be null.</param>
/// <param name="settings">Optional <see cref="SpeechSettings"/>.</param>
/// <returns>The created <see cref="SpeechClient"/>.</returns>
public static SpeechClient Create(Channel channel, SpeechSettings settings = null)
{
GaxPreconditions.CheckNotNull(channel, nameof(channel));
Speech.SpeechClient grpcClient = new Speech.SpeechClient(channel);
return(new SpeechClientImpl(grpcClient, settings));
}
/// <summary>
/// Synchronously creates a <see cref="SpeechClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary.
/// </summary>
/// <param name="endpoint">Optional <see cref="ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="SpeechSettings"/>.</param>
/// <returns>The created <see cref="SpeechClient"/>.</returns>
public static SpeechClient Create(ServiceEndpoint endpoint = null, SpeechSettings settings = null)
{
Channel channel = s_channelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
// Note: we could have parameterless overloads of Create and CreateAsync,
// documented to just use the default endpoint, settings and credentials.
// Pros:
// - Might be more reassuring on first use
// - Allows method group conversions
// Con: overloads!
/// <summary>
/// Asynchronously creates a <see cref="SpeechClient"/>, applying defaults for all unspecified settings,
/// and creating a channel connecting to the given endpoint with application default credentials where
/// necessary.
/// </summary>
/// <param name="endpoint">Optional <see cref="ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="SpeechSettings"/>.</param>
/// <returns>The task representing the created <see cref="SpeechClient"/>.</returns>
public static async Task <SpeechClient> CreateAsync(ServiceEndpoint endpoint = null, SpeechSettings settings = null)
{
Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}
partial void OnConstruction(Speech.SpeechClient grpcClient, SpeechSettings effectiveSettings, ClientHelper clientHelper);
partial void OnCopy(SpeechSettings existing);
private SpeechSettings(SpeechSettings existing) : base(existing)
{
GaxPreconditions.CheckNotNull(existing, nameof(existing));
SyncRecognizeSettings = existing.SyncRecognizeSettings;
AsyncRecognizeSettings = existing.AsyncRecognizeSettings;
}
