JRTCMediaDevice.h

//
//  JRTCMediaDevice.h
//  JRTCSDK
//
//  Created by juphoon on 2017/8/11.
//  Copyright © 2017年 juphoon. All rights reserved.
//
 
#import <Foundation/Foundation.h>
#import "JRTCClient.h"
#import "JRTCMediaDeviceVideoCanvas.h"
#import "JRTCMediaDeviceCallback.h"
#import "JRTCMediaDeviceConstants.h"
#import "JRTCMediaDeviceInitParam.h"
#import "JRTCRecordVideoCaptureParam.h"
 
 
@protocol AudioInputFrameCallback <NSObject>
 
- (void)onFrame:(const char *_Nonnull)inputId sampleRateHz:(int)iSampleRateHz channels:(int)iChannels data:(NSData *_Nullable)data;
 
@end
 
@protocol VideoCaptureFrameCallback <NSObject>
 
- (void)onFrame:(const char *_Nonnull)streamId angle:(int)angle width:(int)width height:(int)height data:(unsigned char *_Nonnull)data;
 
@end
 
@interface JRTCMediaDeviceCamera : NSObject
@property (nonatomic, readonly, nonnull) NSString* cameraId;
@property (nonatomic, readonly, nonnull) NSString* cameraName;
@property (nonatomic, readonly) JRTCMediaDeviceCameraType cameraType;
 
@end
 
@interface JRTCMediaDeviceAudio : NSObject
 
@property (nonatomic, readonly, nonnull) NSString* audioId;
 
@property (nonatomic, readonly, nonnull) NSString* audioName;
 
@property (nonatomic, readonly) bool input;
 
@end
 
@interface JRTCMediaDeviceWindow : NSObject
 
@property (nonatomic, readonly, nonnull) NSString* windowId;
 
@property (nonatomic, readonly, nonnull) NSString* windowName;
 
@end
 
@interface JRTCMediaDeviceAudioParam : NSObject
 
@property (nonatomic) int audioInputSamplingRate;
 
@property (nonatomic) int audioOutputSamplingRate;
 
@property (nonatomic) int audioInputChannelNumber;
 
@property (nonatomic) int audioOutputChannelNumber;
 
@end
 
@interface JRTCMediaDevice : NSObject
 
@property (nonatomic, nullable) id<AudioInputFrameCallback> audioInputFrameCallback;
 
@property (nonatomic, readonly) bool isAudioInputStart;
 
@property (nonatomic, readonly) bool isAudioOutputStart;
 
@property (nonatomic, readonly) bool cameraOpen;
 
@property (nonatomic, readonly) bool videoFileOpen;
 
@property (nonatomic, readonly, nullable) JRTCMediaDeviceCamera* currentCamera;
 
@property (nonatomic, readonly, nonnull) NSArray<JRTCMediaDeviceCamera*> * cameras;
 
@property (nonatomic, nullable) JRTCMediaDeviceCamera* defaultCamera;
 
@property (nonatomic, strong, nonnull) JRTCMediaDeviceAudioParam* audioParam;
 
@property (nonatomic, strong, readonly, nonnull) NSString*  videoFileId;
 
@property (nonatomic, readonly) bool audioInterrupt;
 
@property (nonatomic) JRTCMediaDeviceVideoAngle videoAngle;
 
@property (nonatomic, readonly) bool isAutoScreenOrientation;
@property (nonatomic) bool useInternalAudioDeviceLogic;
 
 
#if TARGET_OS_OSX
@property (nonatomic, readonly, nonnull) NSArray<JRTCMediaDeviceAudio*>* audioInputs;
 
@property (nonatomic, strong, nullable) JRTCMediaDeviceAudio* audioInput;
 
@property (nonatomic, readonly, nonnull) NSArray<JRTCMediaDeviceAudio*>* audioOutputs;
 
@property (nonatomic, strong, nullable) JRTCMediaDeviceAudio* audioOutput;
 
@property (nonatomic, readonly, nonnull) NSArray<JRTCMediaDeviceWindow*>* desktops;
 
@property (nonatomic, readonly, nonnull) NSArray<JRTCMediaDeviceWindow*>* windows;
 
@property (nonatomic, strong, nullable) JRTCMediaDeviceWindow* screenshareWindow;
#endif
 
+ (JRTCMediaDevice* _Nullable)create:(JRTCClient* _Nonnull)client callback:(id<JRTCMediaDeviceCallback> _Nonnull)callback initParam:(JRTCMediaDeviceInitParam* _Nullable)initParam;
 
+ (void)destroy;
 
- (JRTCMediaDeviceVideoCanvas* __nullable)startCameraVideo:(JRTCMediaDeviceRender)renderType;
 
- (JRTCMediaDeviceVideoCanvas* __nullable)startCameraVideo:(JRTCMediaDeviceRender)type view:(JCView* __nonnull)view;
 
- (JRTCMediaDeviceVideoCanvas* __nullable)startVideo:(NSString* __nonnull)streamId renderType:(JRTCMediaDeviceRender)type;
 
- (JRTCMediaDeviceVideoCanvas* __nullable)startVideo:(NSString* __nonnull)streamId renderType:(JRTCMediaDeviceRender)type view:(JCView* __nonnull)view;
 
- (void)stopVideo:(JRTCMediaDeviceVideoCanvas* __nonnull)canvas;
 
- (void)stopAllVideos;
 
- (bool)startAudio;
 
- (bool)stopAudio;
 
- (bool)startAudioInput;
 
- (bool)stopAudioInput;
 
- (bool)startAudioOutput;
 
- (bool)stopAudioOutput;
 
- (bool)startCamera;
 
- (bool)stopCamera;
 
- (bool)switchCamera;
 
- (bool)switchCamera:(JRTCMediaDeviceCamera* __nonnull)camera;
 
- (void)specifyCamera:(JRTCMediaDeviceCamera* __nonnull)camera;
 
- (void)specifyCameraAngle:(int)angle;
 
- (void)setCameraProperty:(int)width height:(int)height framerate:(int)frameRate;
 
- (void)setScreenCaptureProperty:(int)width height:(int)height framerate:(int)frameRate;
 
- (int)getScreenFramerate;
 
- (void)setVideoAngle:(JRTCMediaDeviceVideoAngle)angle;
 
- (void)setAutoScreenOrientation:(bool)enable;
 
#if TARGET_OS_IPHONE || TARGET_IPHONE_SIMULATOR
 
@property (nonatomic) bool defaultSpeakerOn;
 
- (bool)isSpeakerOn;
 
- (void)enableSpeaker:(bool)enable;
 
- (bool)enableScreenCapture:(bool)enable;
 
- (bool)enableScreenCapture:(bool)enable appGroupId:(NSString *__nullable)appGroupId preferredExtension:(NSString *__nullable)preferredExtension;
 
- (JRTCMediaDeviceAudioRouteType)getAudioRouteType;
#endif
 
- (NSString* __nullable) getScreenCaptureId;
 
- (bool)startVideoFile;
 
- (bool)stopVideoFile;
 
- (bool)setVideoFileFrame:(NSData* __nonnull)srcFrame format:(JRTCMediaDeviceVideoPixelFormat)format width:(int)width height:(int)height angle:(int)angle;
 
- (void)setVideoFileFrame:(CVPixelBufferRef __nonnull)srcFrame angle:(int)angle mirror:(int)mirror;
 
- (bool)startVideoCaptureRecord:(NSString *_Nonnull)streamId recordParam:(JRTCRecordVideoCaptureParam *_Nonnull)recordParam;
 
- (bool)startVideoCaptureRecord:(NSString *_Nonnull)filePath streamId:(NSString *_Nonnull)streamId audioSource:(JRTCRecordAudioSource)audioSource fileType:(JRTCVideoRecordFileType)fileType width:(int)width height:(int)height DEPRECATED_MSG_ATTRIBUTE("该方法即将废弃，请使用 startVideoCaptureRecord:recordParam: 替换");
 
- (bool)stopVideoCaptureRecord:(NSString *_Nonnull)streamId;
 
- (bool)startAudioRecord:(NSString *_Nullable)filePath audioSource:(JRTCRecordAudioSource)audioSource fileType:(JRTCAudioRecordFileType)fileType;
 
- (bool)stopAudioRecord;
 
- (bool)recoveryRecordFile:(NSString *_Nonnull)fileDir;
 
- (bool)snapshotWithStreamId:(NSString* __nonnull)streamId path:(NSString* __nonnull)path;
 
- (void)setAudioInputFrameCallback:(id<AudioInputFrameCallback> _Nullable)callback;
 
- (void)setVideoCaptureFrameCallback:(id<VideoCaptureFrameCallback> _Nullable)callback;
 
- (void)setScreenCaptureData:(UIImage * __nonnull)image;
 
- (void)resetScreenCaptureData;
 
- (bool)startAudioTest:(JRTCMediaDeviceTestType)type fileName:(NSString *__nullable)fileName;
 
- (bool)stopAudioTest:(JRTCMediaDeviceTestType)type;
 
- (int)getMicLevel;
 
- (int)getSpkLevel;
 
- (int)getAnrNoiseLevel;
 
- (int)getAnrNoiseRatio;
 
- (bool)startRing:(NSString * _Nonnull)filePath isLoop:(bool)isLoop;
 
- (bool)stopRing;
 
- (bool)enableAudioInputFromFile:(bool)enable filePath:(NSString* __nullable)filePath loop:(bool)loop;
 
- (bool)suspendAudioInputFromFile:(bool)suspend;
 
- (void)setAec:(bool)aecOn;
 
- (void)setAgc:(bool)agcOn;
 
@end