On this page

About the Sharing Bundle ID

Show all

Help Center/ Meeting/ Client SDK Reference/ iOS SDK/ Getting Started/ Screen Sharing Integration

Screen Sharing Integration

Updated on 2024-07-30 GMT+08:00

View PDF

NOTE:

You can share your mobile phone screen with others to improve communication efficiency.

About the Sharing Bundle ID

Bundle ID format of the ScreenShareExtension extension:

Main app bundle ID + ScreenShareExtension

Bundle ID format of the ScreenShareExtensionSetupUI extension:

Main app bundle ID + ScreenShareExtensionSetupUI

Examples:
Assume that the bundle ID of the main app is com.xx.xx.
The bundle ID of the ScreenShareExtension extension will be com.xx.xx.ScreenShareExtension.
The bundle ID of the ScreenShareExtensionSetupUI extension will be com.xx.xx.ScreenShareExtensionSetupUI.

You need to add an iOS extension and configure related code for iOS screen sharing. The following describes how to integrate the SDK to develop the screen sharing extension.

NOTE:

Related features depend on system capabilities. To use the screen sharing function, you need to use iOS 12 or a later version. For more information, see App Extension Programming Guide.

Choose File > New > Target. Then, select the Broadcast Upload Extension template to create an extension target.

Figure 1 Adding a target

Figure 2 Selecting the Broadcast Upload Extension template and clicking Next

Figure 3 Extension named ScreenShareExtension added
Set the iOS version supported by the extension to 12.0.

Figure 4 Setting the extension

Figure 5 Setting the extension UI
Add an app group to the main project and current extension, and set the group ID to that obtained in Preparations.

Figure 6 Default setting (no app groups)

Figure 7 Choosing TARGETS > Signing & Capabilities > Capability to add an app group

Figure 8 Choosing App Groups

Add app groups for ScreenShareExtension and ScreenShareExtensionSetupUI in the same way.

Figure 9 App groups added
Add app group IDs to the entitlement files. (The group IDs are also used during initialization. You can apply for app group IDs from Apple's official website.)

Figure 10 App group ID added to an app

Figure 11 App group ID added to ScreenShareExtension

Figure 12 App group ID added to ScreenShareExtensionSetupUI
Add HWMExtension.framework to ScreenShareExtension. Go to TARGETS > ScreenShareExtension > Build Settings > Other Linker Flags and add -lc++.

Figure 13 Choosing ScreenShareExtension > Add Files to...

Figure 14 Adding HWMExtension.framework to ScreenShareExtension

Figure 15 Effect after HWMExtension.framework is added to ScreenShareExtension

Configure the screen sharing code. Specifically, add the following code to the SampleHandler.m file of ScreenShareExtension.

Figure 16 SampleHandler location

The file can be directly used after the group ID is modified.

      
       
         
         #import "SampleHandler.h"
#import <HWMExtension/HWMExtension.h>
 
 @interface SampleHandler()<ScreenShareManagerDelegate>
 @property (strong, nonatomic) HWMExensionDataManager *screenShareManager;
 @end
 
 @implementation SampleHandler
 
 - (instancetype)init {
     if (self = [super init]) {
//         [HWMExtensionAppGroup setAppGroup:@"group.com.huawei.xxx"];// Replace the corresponding value with the app group you obtain.
        self.screenShareManager = [[HWMExensionDataManager alloc] init];
        self.screenShareManager.delegate = self;
     }
     return self;
 }
 
- (void)dealloc {
    self.screenShareManager = nil;
}
 
- (void)broadcastStartedWithSetupInfo:(NSDictionary<NSString *,NSObject *> *)setupInfo {
    // User has requested to start the broadcast. Setup info from the UI extension can be supplied but optional.
    [self.screenShareManager broadcastStartedWithSetupInfo:setupInfo];
}
 
- (void)broadcastPaused {
    // User has requested to pause the broadcast. Samples will stop being delivered.
    [self.screenShareManager broadcastPaused];
}
 
- (void)broadcastResumed {
    // User has requested to resume the broadcast. Samples delivery will resume.
    [self.screenShareManager broadcastResumed];
}
 
- (void)broadcastFinished {
    // User has requested to finish the broadcast.
    [self.screenShareManager broadcastFinished];
}
 
- (void)processSampleBuffer:(CMSampleBufferRef)sampleBuffer withType:(RPSampleBufferType)sampleBufferType {
    switch (sampleBufferType) {
        case RPSampleBufferTypeVideo:
            // Handle video sample buffer
            [self.screenShareManager processSampleBuffer:sampleBuffer withType:RPSampleBufferTypeVideo];  
            break;
        case RPSampleBufferTypeAudioApp:
            // Handle audio sample buffer for app audio
            // Audio sharing-related
            if ([self currentIsAudioShare]) {
                [self.screenShareManager processSampleBuffer:sampleBuffer withType:RPSampleBufferTypeAudioApp];
            }
            break;
        case RPSampleBufferTypeAudioMic:
            // Handle audio sample buffer for mic audio
            break;
            
        default:
            break;
    }
}
 
- (void)screenShareManagerFinishBroadcastWithError:(NSError *)error {
    [self.screenShareManager broadcastFinished];
    [self finishBroadcastWithError: error];
}
- (BOOL)currentIsAudioShare {
    NSUserDefaults *userDefault = [[NSUserDefaults alloc] initWithSuiteName:[HWMExtensionAppGroup getAppGroup]];
    NSString *audioShareType = [userDefault objectForKey:kHWMExtensionAudioShareKey];
    if ([audioShareType isEqualToString:kHWMExtensionAudioShareValue]) {
        return YES;
    }
    return NO;
}
 @end

        

      
     