/// <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. See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Cloud.Speech.V1;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// SpeechClient client = await SpeechClient.CreateAsync();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Cloud.Speech.V1;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// SpeechClient.DefaultEndpoint.Host, SpeechClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// SpeechClient client = SpeechClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// await channel.ShutdownAsync();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="SpeechSettings"/>.</param>
/// <returns>The task representing the created <see cref="SpeechClient"/>.</returns>
public static async stt::Task <SpeechClient> CreateAsync(gaxgrpc::ServiceEndpoint endpoint = null, SpeechSettings settings = null)
{
grpccore::Channel channel = await s_channelPool.GetChannelAsync(endpoint ?? DefaultEndpoint).ConfigureAwait(false);
return(Create(channel, settings));
}
partial void OnCopy(SpeechSettings existing);
partial void OnConstruction(Speech.SpeechClient grpcClient, SpeechSettings effectiveSettings, ClientHelper clientHelper);
/// <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));
}
/// <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));
}
private SpeechSettings(SpeechSettings existing) : base(existing)
{
GaxPreconditions.CheckNotNull(existing, nameof(existing));
NonStreamingRecognizeSettings = existing.NonStreamingRecognizeSettings?.Clone();
}
/// <summary>
/// Wrap a GRPC Speech client for more convenient use.
/// </summary>
/// <param name="grpcClient">A GRPC client to wrap.</param>
/// <param name="settings">
/// An optional <see cref="SpeechSettings"/> to configure this wrapper.
/// If null or not specified, then the default settings are used.
/// </param>
/// <returns>A <see cref="SpeechClient"/> that wraps the specified GRPC client.</returns>
public static SpeechClient ToClient(
this Speech.SpeechClient grpcClient,
SpeechSettings settings = null
) => new SpeechClientImpl(grpcClient, settings);
/// <summary>
/// Creates a <see cref="SpeechClient"/> which uses the specified channel for remote operations.
/// </summary>
/// <param name="channel">The <see cref="grpccore::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(grpccore::Channel channel, SpeechSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(channel, nameof(channel));
return(Create(new grpccore::DefaultCallInvoker(channel), 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.
/// See the example for how to use custom credentials.
/// </summary>
/// <example>
/// This sample shows how to create a client using default credentials:
/// <code>
/// using Google.Cloud.Vision.V1;
/// ...
/// // When running on Google Cloud Platform this will use the project Compute Credential.
/// // Or set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of a JSON
/// // credential file to use that credential.
/// ImageAnnotatorClient client = ImageAnnotatorClient.Create();
/// </code>
/// This sample shows how to create a client using credentials loaded from a JSON file:
/// <code>
/// using Google.Cloud.Vision.V1;
/// using Google.Apis.Auth.OAuth2;
/// using Grpc.Auth;
/// using Grpc.Core;
/// ...
/// GoogleCredential cred = GoogleCredential.FromFile("/path/to/credentials.json");
/// Channel channel = new Channel(
/// ImageAnnotatorClient.DefaultEndpoint.Host, ImageAnnotatorClient.DefaultEndpoint.Port, cred.ToChannelCredentials());
/// ImageAnnotatorClient client = ImageAnnotatorClient.Create(channel);
/// ...
/// // Shutdown the channel when it is no longer required.
/// channel.ShutdownAsync().Wait();
/// </code>
/// </example>
/// <param name="endpoint">Optional <see cref="gaxgrpc::ServiceEndpoint"/>.</param>
/// <param name="settings">Optional <see cref="SpeechSettings"/>.</param>
/// <returns>The created <see cref="SpeechClient"/>.</returns>
public static SpeechClient Create(gaxgrpc::ServiceEndpoint endpoint = null, SpeechSettings settings = null)
{
grpccore::Channel channel = ChannelPool.GetChannel(endpoint ?? DefaultEndpoint);
return(Create(channel, settings));
}
/// <summary>
/// Creates a <see cref="SpeechClient"/> which uses the specified call invoker for remote operations.
/// </summary>
/// <param name="callInvoker">The <see cref="grpccore::CallInvoker"/> 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(grpccore::CallInvoker callInvoker, SpeechSettings settings = null)
{
gax::GaxPreconditions.CheckNotNull(callInvoker, nameof(callInvoker));
Speech.SpeechClient grpcClient = new Speech.SpeechClient(callInvoker);
return(new SpeechClientImpl(grpcClient, settings));
}