Siprix Custom Video Placeholder Feature Request

[mikaelwills]

Sorry to send through so many issues towards the end of the year ha

The SiprixVideoView widget currently shows a hardcoded Placeholder() widget when renderer.hasTexture is false:

@override
Widget build(BuildContext context) {
  return _renderer.hasTexture
    ? AspectRatio(aspectRatio: _renderer.aspectRatio,
        child: Texture(textureId: _renderer.textureId, filterQuality: filterQuality))
    : const Placeholder();  // ← Hardcoded placeholder
}

Apps cannot match their brand/design system when video isn't available

Could we add an optional placeholder parameter to SiprixVideoView:

class SiprixVideoView extends StatelessWidget {
  const SiprixVideoView(
    this._renderer, {
    Key? key,
    this.placeholder,  // ← New optional parameter
  }) : super(key: key);

  final SiprixVideoRenderer _renderer;
  final Widget? placeholder;  // ← New field
  final FilterQuality filterQuality = FilterQuality.low;

  @override
  Widget build(BuildContext context) {
    return _renderer.hasTexture
      ? AspectRatio(
          aspectRatio: _renderer.aspectRatio,
          child: Texture(
            textureId: _renderer.textureId,
            filterQuality: filterQuality,
          ),
        )
      : placeholder ?? const Placeholder();  // ← Use custom or fallback to default
  }
}

Usage Example

// Custom placeholder matching app design
SiprixVideoView(
  _remoteRenderer,
  placeholder: Container(
    color: Colors.black,
    child: Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Icon(Icons.videocam_off, size: 64, color: Colors.white54),
          SizedBox(height: 16),
          Text('Camera not available', style: TextStyle(color: Colors.white54)),
        ],
      ),
    ),
  ),
)

I tried wrapping SiprixVideoView in a custom widget works but checking if the renderer has a texture leads to true because the placeholder comes through so it just shows that.

[siprix]

You can do this more efficient in the following way:

  Widget buildRemoteVideo() {
    return _remoteRenderer.hasTexture
      ? SiprixVideoView(_remoteRenderer)
      : Container(color: Colors.black, child:
          Column(mainAxisAlignment: MainAxisAlignment.center, children: [
            Icon(Icons.videocam_off, size: 64, color: Colors.white54),
            SizedBox(height: 16),
            Text('Camera not available', style: TextStyle(color: Colors.white54)),
          ])
        );
  }

Create own placeholder only when it's really required.

[mikaelwills]

Hey yea, i tried this but the issue is that Siprix sends a default placeholder image through the texture when no video is available. From Flutter's perspective, hasTexture is true and we receive valid dimensions, so we can't distinguish between real video and Siprix's placeholder. Could you either:

1. Add a hasRealVideo property to SiprixVideoRenderer, or
2. Add the optional placeholder parameter to SiprixVideoView?

[siprix]

Siprix sends a default placeholder image through the texture when no video is available

What do you mean as "default placeholder image"?
If you have case when 'hasTexture is true' and some placeholder displayed most probably it's fallback on sender side, which generates white frames with logo and sends them when image from camera can't be retrieved.

App can set own image instead of camera using code like (copied from example app):

VideoData vdoData = VideoData();
vdoData.noCameraImgPath = await MyApp.writeAssetAndGetFilePath("noCamera.jpg");
..
SiprixVoipSdk().setVideoParams(vdoData);

[mikaelwills]

@siprix The issue is that when the remote side has no camera (not "camera unavailable temporarily" but "device has no camera at all"), Siprix still reports hasTexture=true with real dimensions (352x640 in my testing), which is that default noCameraImgPath coming through.

This prevents any app from detecting the "no remote video" state. I need to know when there's genuinely no video stream so I can:

• Keep local video fullscreen instead of PIP
• Show my own UI appropriate for one-way video calls
• Not allocate/display a remote video view at all

I think it would be better If remote has no video stream, hasTexture should be false or dimensions should be 0x0, letting the app decide how to handle it.

Right now Siprix sends placeholder frames with real dimensions, making it impossible to distinguish "no video" from "has video".

[siprix]

Is your app running on "no camera" device?
There is another problem with such devices.
When it's connected to LAN under NAT it should send something, which causes to open UDP ports between local and remote sides (UDP hole punching). Otherwise it may not able to receive any video from remote side.

We can add some option, which prevents generating placeholder frames.