Overview

It all comes down to this. All the setup so far has been done so that we can show live streaming video in our beautiful apps.

1. First, you need to get all the peers in the room. You can use the selectPeers selector for this.

2. Next, you'll need to have a reference to a video element. You must add the attributes as present below.

<video autoplay muted playsinline />

3. You can then iterate over all the peers, and call the attachVideo function in hmsActions to render the video.

hmsActions.attachVideo(videoTrack.id, videoElement);

The videos will now be rendered & start playing on your screen. 🥳

Detach video to conserve bandwidth and cleanup elements

You can call detachVideo on the hmsActions to unsubscribe a track and not fetch it's data. This can be done for example when a video goes out of view. This should also be called when the component is going to be unmounted for proper cleanups of the video elements.

hmsActions.detachVideo(videoTrack.id, videoElement);

When to attach/detach videos

Starting from this release, sdk handles the subsequent attach/detach automatically.

• attach needs to be called only the first time the video element is available. subsequent calls will be ignored.
• detach needs to be called only when the element is removed from the dom while the track is still available. For the majority of cases, calling detach won't be needed.

To disable the auto handling by sdk, pass autoManageVideo: false in join or preview config object. Then you will have to follow the below snippet to handle video rendering on your end.

We need to re-attach video when it's in view after every:

1. Unmute(when track.enable is true)
2. Plugin is added/removed(for example, enable/disable virtual background)
3. Camera/device change(track.deviceId is changed)

You can achieve all this by using the selectVideoTrackByID selector and the aforementioned hmsActions.attachVideo and hmsActions.detachVideo functions.

// assuming you have peer object and video element
// complete code snippet below
hmsStore.subscribe((track) => {
    if (!track) {
        return;
    }
    if (track?.enabled) {
        hmsActions.attachVideo(track.id, videoElement);
    } else {
        hmsActions.detachVideo(track.id, videoElement);
    }
}, selectVideoTrackByID(peer.videoTrack));

Example Snippet

import { hmsActions } from './hms';

const peersContainer = document.getElementById('peers-container');

// store peer IDs already rendered to avoid re-render on mute/unmute
const renderedPeerIDs = new Set();

// render a single peer video tile
function renderPeer(peer) {
    const peerTileDiv = document.createElement('div');
    // you can either get an existing video element or create a new one.
    const videoElement = document.createElement('video');
    const peerTileName = document.createElement('div');
    videoElement.autoplay = true;
    videoElement.muted = true;
    videoElement.playsinline = true;
    peerTileName.textContent = peer.name;

    hmsStore.subscribe((track) => {
        if (!track) {
            return;
        }
        if (track.enabled) {
            hmsActions.attachVideo(track.id, videoElement);
        } else {
            hmsActions.detachVideo(track.id, videoElement);
        }
    }, selectVideoTrackByID(peer.videoTrack));

    peerTileDiv.append(videoElement);
    peerTileDiv.append(peerTileName);

    renderedPeerIDs.add(peer.id);
    return peerTileDiv;
}

// display a tile for each peer in the peer list
function renderPeers(peers) {
    peersContainer = document.getElementById('peers-container');

    peers.forEach((peer) => {
        if (!renderedPeerIDs.has(peer.id) && peer.videoTrack) {
            console.log(
                `rendering video for peer - ${peer.name}, roleName - ${peer.roleName}, isLocal- ${peer.isLocal}`
            );
            peersContainer.append(renderVideo(peer));
        }
    });
}

// subscribe to the peers, so render is called whenever there is a change like peer join and leave
hmsStore.subscribe(renderPeers, selectPeers);

import { useRef, useEffect } from 'react';
import { useHMSStore, useVideo, selectPeers } from '@100mslive/react-sdk';

function VideoTile({ peer }) {
    const { videoRef } = useVideo({
        trackId: peer.videoTrack
    });

    return <video ref={videoRef} autoPlay muted playsInline></video>;
}

function Conference() {
    const peers = useHMSStore(selectPeers);

    return (
        <>
            {peers.map((peer) => (
                <VideoTile key={peer.id} peer={peer} />
            ))}
        </>
    );
}

Mirror video

To mirror local peer's video, apply the following CSS style to the video element.

/** enable mirror with -1 */
transform: scaleX(-1);

The 100ms sample app already does this by default. To turn it off, you can override this styling in code or disable the "Mirror Local Tile" from layout settings.