ApsaraVideo Live:Implement screen sharing on different devices

1. Screen sharing

1.1 Start screen sharing

/*
* Share a part of the screen.
*/
/*
* Share a part of the screen.
*/
      RECT rc;
      ::GetWindowRect(::GetDesktopWindow(), &rc);

      AliEngineScreenShareRegion screenRegion;
      screenRegion.originX = (float)rc.left;
      screenRegion.originY = (float)rc.top;
      screenRegion.width = (float)(rc.right - rc.left);
      screenRegion.height = (float)(rc.bottom - rc.top);

      AliEngineScreenShareConfig config;

      config.isShareByRegion = false;
      config.shareRegion = screenRegion;
      
      mpEngine->StartScreenShareByScreenRegion(screenRegion, config);

1.2 Stop screen sharing

mpEngine->StopScreenShare();

2. Multi-window sharing

2.1 Enumerate all shareable windows or desktops

mScreenShareType = AliEngineScreenShareDesktop ; 
mScreenShareType = AliEngineScreenShareWindow ; 

/*
 mSourceId The ID that was previously selected. The following code populates a ComboBox list.
*/

mCurrentSourceList = mEngine->GetScreenShareSourceInfo(mScreenShareType);
  if (nullptr != mCurrentSourceList)
  {
      for (size_t i = 0; i < mCurrentSourceList->GetCount(); i++) {
        AliEngineScreenSourcInfo info = mCurrentSourceList->GetSourceInfo(i);

        /*
        * If you do not want to share the window of the application itself, use sourceIsSelf to distinguish it from others.
        */
        info.sourceIsSelf 
        CString s = AliStringToCString(info.sourceName);
        lb->AddString(s);
        if (mSourceId == info.sourceId) {
          lb->SetCurSel(i);
        }
      }
      
      /*
      * By default, the first window or desktop is selected. The ID and name of the window or desktop are recorded.
      */
      if (mSourceId.isEmpty() && lb->GetCount() > 0)
      {
        lb->SetCurSel(0);
        AliEngineScreenSourcInfo info = mCurrentSourceList->GetSourceInfo(0);
        mSourceId = info.sourceId;
        mSourceTitle = info.sourceName;
      }
  }

2.2 Share a corresponding window or desktop

msSourceId is the ID of the shared window or desktop, which can be obtained from the preceding enumeration method.
screenShareSource indicates the configuration.

AliEngineScreenShareRegion  shareRegion ;
shareRegion.originX = 0.f;
shareRegion.originY = 0.f;
shareRegion.width = 640.f;
shareRegion.height = 480.f;
            
screenShareSource.isShareByRegion = true ;
screenShareSource.shareRegion =  shareRegion;

/*
* Share a desktop.
*/
mpEngine->StartScreenShareByDesktopId(atol(msSourceId.c_str()), screenShareSource);

/*
* Share a window.
*/
mpEngine->StartScreenShareByWindowId(atol(msSourceId.c_str()), screenShareSource);

/*
* Obtain the display scope of the shared window or desktop.
*/
AliEngineScreenShareRegion region;
		mEngine->GetDesktopRegion(mSourceId, mSourceTitle, region);
		CString resolutionMsg;
		resolutionMsg.Format(_T("Resolution: %d x %d"), region.width, region.height);
		((CStatic*)GetDlgItem(IDC_STATIC_SCREEN_SOURCE_RESOLUTION))->SetWindowTextW(resolutionMsg);
		((CEdit*)GetDlgItem(IDC_EDIT_SHARE_REGION_X))->SetWindowTextW(std::to_wstring(mScreenShareSource.shareRegion.originX).c_str());
		((CEdit*)GetDlgItem(IDC_EDIT_SHARE_REGION_Y))->SetWindowTextW(std::to_wstring(mScreenShareSource.shareRegion.originY).c_str());
		((CEdit*)GetDlgItem(IDC_EDIT_SHARE_REGION_X2))->SetWindowTextW(std::to_wstring(mScreenShareSource.shareRegion.width).c_str());
		((CEdit*)GetDlgItem(IDC_EDIT_SHARE_REGION_Y2))->SetWindowTextW(std::to_wstring(mScreenShareSource.shareRegion.height).c_str());
	}
  

2.3 Stop sharing a corresponding window or desktop

mpEngine->StopScreenShare();

II. iOS

    AliRtcScreenShareMode mode = AliRtcScreenShareNone;

 /*
 * Specify whether to share the audio based on your business requirements.
 */
    if (ctrl.shareVideo) {
      mode |= AliRtcScreenShareVideo;
    }
    
    if (ctrl.shareAudioApp) {
      mode |= AliRtcScreenShareAudioApp;
    }
    
    [strongSelf.engine startScreenShare:kAppGroup mode:mode];
    [strongSelf.engine setAudioShareAppVolume:ctrl.appPublishVolume];

[strongSelf.engine stopScreenShare];

/* Call relevant methods and change the parameter values. */
if (ctrl.enablePublishScreenTrackConfig) {
   [strongSelf.engine setPublishVideoStreamAttribute:AliRtcVideoTrackScreen attr:@"range=mpu"];
} else {
    [strongSelf.engine setPublishVideoStreamAttribute:AliRtcVideoTrackScreen attr:@""];
}

/* Republish the screen track. You can perform this operation only after you stop stream ingest. */
[strongSelf.engine stopScreenShare];

AliRtcScreenShareMode mode = AliRtcScreenShareNone;

if (ctrl.shareVideo) {
   mode |= AliRtcScreenShareVideo;
}

if (ctrl.shareAudioApp) {
   mode |= AliRtcScreenShareAudioApp;
}

[strongSelf.engine startScreenShare:kAppGroup mode:mode];
[strongSelf.engine setAudioShareAppVolume:ctrl.appPublishVolume];
            

III. Android

if (config.permitScreen && config.permitAudioShare) {
    mScreenShareMode = AliRtcEngine.AliRtcScreenShareMode.AliRtcScreenShareAllMode;
} else if (config.permitScreen) {
    mScreenShareMode = AliRtcEngine.AliRtcScreenShareMode.AliRtcScreenShareOnlyVideoMode;
} else if (config.permitAudioShare) {
    mScreenShareMode = AliRtcEngine.AliRtcScreenShareMode.AliRtcScreenShareOnlyAudioMode;
}
      
mAliRtcEngine.startScreenShare(null, mScreenShareMode);

pubScreenCaptureResult = mAliRtcEngine.stopScreenShare();