web

Documentation

Overview

Package web provides gRPC/REST/GUI APIs to control and monitor a robot.

Index

• func RunWeb(ctx context.Context, r robot.LocalRobot, o weboptions.Options, ...) (err error)
• func RunWebWithConfig(ctx context.Context, r robot.LocalRobot, cfg *config.Config, ...) error
• type Option
  • func WithStreamConfig(config gostream.StreamConfig) Option
• type Service
  • func New(ctx context.Context, r robot.Robot, logger golog.Logger, opts ...Option) Service
• type StreamServer

Functions

func RunWeb

func RunWeb(ctx context.Context, r robot.LocalRobot, o weboptions.Options, logger golog.Logger) (err error)

RunWeb starts the web server on the robot with web options and blocks until we cancel the context.

func RunWebWithConfig

func RunWebWithConfig(ctx context.Context, r robot.LocalRobot, cfg *config.Config, logger golog.Logger) error

RunWebWithConfig starts the web server on the robot with a robot config and blocks until we cancel the context.

Types

type Option

type Option interface {
	// contains filtered or unexported methods
}

Option configures how we set up the web service. Cribbed from https://github.com/grpc/grpc-go/blob/aff571cc86e6e7e740130dbbb32a9741558db805/dialoptions.go#L41

func WithStreamConfig

func WithStreamConfig(config gostream.StreamConfig) Option

WithStreamConfig returns an Option which sets the streamConfig used to enable audio/video streaming over WebRTC.

type Service

type Service interface {
	// Start starts the web server
	Start(context.Context, weboptions.Options) error

	// Close closes the web server
	Close() error
}

A Service controls the web server for a robot.

func New

func New(ctx context.Context, r robot.Robot, logger golog.Logger, opts ...Option) Service

New returns a new web service for the given robot.

type StreamServer

type StreamServer struct {
	// Server serves streams
	Server gostream.StreamServer
	// HasStreams is true if service has streams that require a WebRTC connection.
	HasStreams bool
}

StreamServer manages streams and displays.