PluginEventChannel<T> class
Null safety
A named channel for sending events to the framework-side using streams.
This is the platform-side equivalent of EventChannel. Whereas EventChannel receives a stream of events from platform plugins, this channel sends a stream of events to the handler listening on the framework-side.
The channel name must not be null. If no codec is provided, then StandardMethodCodec is used. If no binaryMessenger is provided, then pluginBinaryMessenger, which sends messages to the framework-side, is used.
Channels created using this class implement two methods for subscribing to the event stream. The methods use the encoding of the specified codec.
The first method is listen
. When called, it begins forwarding
messages to the framework side when they are added to the
controller
. This triggers the StreamController.onListen callback
on the controller
.
The other method is cancel
. When called, it stops forwarding
events to the framework. This triggers the StreamController.onCancel
callback on the controller
.
Events added to the controller
when the framework is not
subscribed are silently discarded.
Constructors
- PluginEventChannel(String name, [MethodCodec codec = const StandardMethodCodec(), BinaryMessenger? binaryMessenger])
-
Creates a new plugin event channel. [...]
const
Properties
- binaryMessenger → BinaryMessenger?
-
The messenger used by this channel to send platform messages. [...]
final
- codec → MethodCodec
-
The message codec used by this channel. [...]
final
-
controller
← StreamController<
T> -
Use setController instead. [...]
@Deprecated('Replace calls to the "controller" setter with calls to the "setController" method. ' 'This feature was deprecated after v1.23.0-7.0.pre.'), write-only
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- name → String
-
The logical channel on which communication happens. [...]
final
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
setController(
StreamController< T> ? controller) → void - Changes the stream controller for this event channel. [...]
-
toString(
) → String -
A string representation of this object. [...]
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator. [...]
inherited