speech

Documentation

Overview

Package speech is an experimental, auto-generated package for the speech API.

Google Cloud Speech API.

Index

• type CallOptions
• type Client
  • func NewClient(ctx context.Context, opts ...option.ClientOption) (*Client, error)
  • func (c *Client) AsyncRecognize(ctx context.Context, req *speechpb.AsyncRecognizeRequest) (*longrunning.Operation, error)
  • func (c *Client) Close() error
  • func (c *Client) Connection() *grpc.ClientConn
  • func (c *Client) SetGoogleClientInfo(name, version string)
  • func (c *Client) StreamingRecognize(ctx context.Context) (speechpb.Speech_StreamingRecognizeClient, error)
  • func (c *Client) SyncRecognize(ctx context.Context, req *speechpb.SyncRecognizeRequest) (*speechpb.SyncRecognizeResponse, error)

Examples

• Client.AsyncRecognize
• Client.SyncRecognize
• NewClient

Types

type CallOptions

type CallOptions struct {
	SyncRecognize      []gax.CallOption
	AsyncRecognize     []gax.CallOption
	StreamingRecognize []gax.CallOption
}

CallOptions contains the retry settings for each method of Client.

type Client

type Client struct {

	// The call options for this service.
	CallOptions *CallOptions
	// contains filtered or unexported fields
}

Client is a client for interacting with Google Cloud Speech API.

func NewClient

func NewClient(ctx context.Context, opts ...option.ClientOption) (*Client, error)

NewClient creates a new speech client.

Service that implements Google Cloud Speech API.

Example

ctx := context.Background()
c, err := speech.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*Client) AsyncRecognize

func (c *Client) AsyncRecognize(ctx context.Context, req *speechpb.AsyncRecognizeRequest) (*longrunning.Operation, error)

AsyncRecognize perform asynchronous speech-recognition: receive results via the google.longrunning.Operations interface. Returns either an `Operation.error` or an `Operation.response` which contains an `AsyncRecognizeResponse` message.

Example

ctx := context.Background()
c, err := speech.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &speechpb.AsyncRecognizeRequest{
	// TODO: Fill request struct fields.
}
op, err := c.AsyncRecognize(ctx, req)
if err != nil {
	// TODO: Handle error.
}

var resp ptypes.DynamicAny // resp can also be concrete protobuf-generated types.
if err := op.Wait(ctx, &resp); err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.

func (*Client) Close

func (c *Client) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*Client) Connection

func (c *Client) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*Client) SetGoogleClientInfo

func (c *Client) SetGoogleClientInfo(name, version string)

SetGoogleClientInfo sets the name and version of the application in the `x-goog-api-client` header passed on each request. Intended for use by Google-written clients.

func (*Client) StreamingRecognize

func (c *Client) StreamingRecognize(ctx context.Context) (speechpb.Speech_StreamingRecognizeClient, error)

StreamingRecognize perform bidirectional streaming speech-recognition: receive results while sending audio. This method is only available via the gRPC API (not REST).

func (*Client) SyncRecognize

func (c *Client) SyncRecognize(ctx context.Context, req *speechpb.SyncRecognizeRequest) (*speechpb.SyncRecognizeResponse, error)

SyncRecognize perform synchronous speech-recognition: receive results after all audio has been sent and processed.

Example

ctx := context.Background()
c, err := speech.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &speechpb.SyncRecognizeRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.SyncRecognize(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp