Function NewAPI

api.go:30–64

NewAPI Creates a new API object for keeping semi-global settings to WebRTC objects It uses the default Codecs and Interceptors unless you customize them using WithMediaEngine and WithInterceptorRegistry respectively.

(options ...func(*API))

// It uses the default Codecs and Interceptors unless you customize them
// using WithMediaEngine and WithInterceptorRegistry respectively.
func NewAPI(options ...func(*API)) *API {
	api := &API{
		interceptor:   &interceptor.NoOp{},
		settingEngine: &SettingEngine{},
	}

	for _, o := range options {
		o(api)
	}

	if api.settingEngine.LoggerFactory == nil {
		api.settingEngine.LoggerFactory = logging.NewDefaultLoggerFactory()
	}

	logger := api.settingEngine.LoggerFactory.NewLogger("api")

	if api.mediaEngine == nil {
		api.mediaEngine = &MediaEngine{}
		err := api.mediaEngine.RegisterDefaultCodecs()
		if err != nil {
			logger.Errorf("Failed to register default codecs %s", err)
		}
	}

	if api.interceptorRegistry == nil {
		api.interceptorRegistry = &interceptor.Registry{}
		err := RegisterDefaultInterceptorsWithOptions(api.mediaEngine, api.interceptorRegistry,
			WithInterceptorLoggerFactory(api.settingEngine.LoggerFactory))
		if err != nil {
			logger.Errorf("Failed to register default interceptors %s", err)
		}
	}

	return api
}

// WithMediaEngine allows providing a MediaEngine to the API.
// Settings can be changed after passing the engine to an API.