iOS/macOS(Objective-C)[v1.7.5.0]
|
PanoRtcEngineKit 接口类提供了应用程序调用所需的所有方法。 更多...
#import <PanoRtcEngineKit.h>
类方法 | |
(instancetype) | + new |
此方法不可用。 | |
(instancetype _Nonnull) | + engineWithConfig:delegate: |
创建一个 PanoRtcEngineKit 对象。 更多... | |
(void) | + setLogLevel: |
设置日志输出级别。 更多... | |
(NSString *_Nonnull) | + getSdkVersion |
返回 PANO SDK 的版本信息 更多... | |
属性 | |
PanoRtcVideoStreamManager * | videoStreamManager |
获取视频流管理器对象。 更多... | |
PanoRtcAnnotationManager * | annotationManager |
获取标注管理器对象。 更多... | |
PanoRtcMessage * | messageService |
获取消息服务的接口指针 更多... | |
PanoRtcRemoteController * | remoteController |
获取远程控制服务的接口指针 更多... | |
PanoRtcGroupManager * | groupManager |
获取分组管理器的接口指针 更多... | |
PanoRtcVideoRenderManager * | videoRenderManager |
获取视频渲染管理器 更多... | |
PanoRtcRecording * | recordingService |
获取录制服务接口 更多... | |
PanoRtcEngineKit 接口类提供了应用程序调用所需的所有方法。
PanoRtcEngineKit 是SDK的基本接口类。创建一个 PanoRtcEngineKit 对象,然后调用该对象的方法就可以使用SDK的通信功能。
- (PanoResult) addSharedScreenSource: | (PanoScreenSourceID) | id | |
withType: | (PanoScreenSourceType) | type | |
添加屏幕采集源,必须在 beginScreenConfiguration 之后调用。(仅限macOS)
id | 屏幕源唯一标识. |
type | PanoScreenSourceType 枚举类型,不能为 kPanoScreen 类型。 |
- (PanoResult) addUnsharedScreenSource: | (PanoScreenSourceID) | id | |
withType: | (PanoScreenSourceType) | type | |
添加不被共享的屏幕源,必须在 beginScreenConfiguration 之后调用。(仅限macOS)
id | 屏幕源唯一标识. |
type | PanoScreenSourceType 枚举类型,不能为显示器类型。 |
- (PanoResult) beginScreenConfiguration: | (BOOL) | resetConfig |
开始配置更改,接下来的配置改变在调用commitConfiguration之前不会立即生效。(仅限macOS)
resetConfig | 是否重置当前配置。 |
- (PanoResult) callout: | (NSString *_Nonnull) | phoneNo | |
bindToUser: | (BOOL) | bindToUser | |
拨打电话号码。
phoneNo | 电话号码。 |
bindToUser | 是否绑定到用户。 |
- (PanoResult) commitScreenConfiguration |
提交一组配置更改。(仅限macOS)
- (PanoResult) createAudioMixingTask: | (SInt64) | taskId | |
filename: | (NSString *_Nonnull) | filename | |
创建混音任务。
taskId | 任务标识。 |
filename | 音频文件的完整路径。支持mp3,aac,wav。 |
- (void) destroy |
销毁 PanoRtcEngineKit 对象。
- (PanoResult) destroyAudioMixingTask: | (SInt64) | taskId |
销毁混音任务。
taskId | 任务标识。 |
- (PanoResult) dropCall: | (NSString *) | phoneNo |
挂断拨出或拨入的电话。
phoneNo | 电话号码。空值为挂断绑定到自己的电话。 |
- (PanoResult) enableSreenFilterSelfApp: | (BOOL) | enable |
设置是否过滤自己进程。(仅限macOS)
enable | 是否过滤自己进程。 |
+ (instancetype _Nonnull) engineWithConfig: | (PanoRtcEngineConfig *_Nonnull) | config | |
delegate: | (id< PanoRtcEngineDelegate > _Nonnull) | delegate | |
创建一个 PanoRtcEngineKit 对象。
config | PanoRtcEngineConfig 对象. |
delegate | PanoRtcEngineDelegate 协议对象. |
- (NSArray< PanoRtcDeviceInfo * > *_Nullable) enumerateDevices: | (PanoDeviceType) | type |
- (NSArray< PanoRtcScreenSourceInfo * > *_Nullable) enumerateScreenSources: | (PanoScreenSourceType) | type |
- (PanoRtcExternalAudioPlayer *_Nonnull) externalAudioPlayer |
获取外接音频播放设备。
- (PanoRtcExternalAudioRecorder *_Nonnull) externalAudioRecorder |
获取外接音频录制设备。
- (UInt32) getAudioDeviceVolume: | (PanoDeviceType) | type |
获取当前音频设备的音量。
type | 设备类型,PanoDeviceType 枚举类型。 |
- (SInt64) getAudioMixingCurrentTimestamp: | (SInt64) | taskId |
获取当前时间戳。
taskId | 任务标识。 |
- (SInt64) getAudioMixingDuration: | (SInt64) | taskId |
获取音频文件的总时长。
taskId | 任务标识。 |
- (PanoRtcCameraController *) getCameraController: | (NSString *_Nonnull) | deviceId |
获取相机控制器的接口指针
- (NSString *_Nullable) getCameraDeviceId: | (BOOL) | frontCamera |
获取摄像头设备标识。(仅限iOS)
frontCamera | 摄像头设备类型,YES是前置摄像头,NO是后置摄像头。 |
- (NSString *_Nullable) getDevice: | (PanoDeviceType) | type |
获取当前设备。(仅限macOS)
type | 设备类型,PanoDeviceType 枚举类型。 |
- (void *_Nullable) getNativeHandle |
返回原生 PANO RtcEngine 句柄。
- (SInt16) getPlayoutLevel |
获取音频播放强度值。
- (SInt16) getRecordingLevel |
获取音频采集强度值。
+ (NSString *_Nonnull) getSdkVersion |
返回 PANO SDK 的版本信息
- (SInt16) getTestPlayoutLevel |
获取播放设备测试时的音频播放强度值。(仅限macOS)
- (SInt16) getTestRecordingLevel |
获取录制设备测试时的音频采集强度值。(仅限macOS)
- (BOOL) isDefaultDeviceWithType: | (PanoDeviceType) | type |
检查当前设备是否为系统默认设备。(仅限macOS)
type | 设备类型,PanoDeviceType 枚举类型。 |
- (BOOL) isEnabledLoudspeaker |
获取扬声器启用状态。(仅限iOS)
- (BOOL) isFrontCamera |
获取当前摄像头类型。(仅限iOS)
- (BOOL) isMultiCameraCaptureSupported |
指示此设备是否支持多摄像头采集。(仅限iOS)
- (PanoResult) joinChannelWithToken: | (NSString *_Nonnull) | token | |
channelId: | (NSString *_Nonnull) | channelId | |
userId: | (UInt64) | userId | |
config: | (PanoRtcChannelConfig *_Nullable) | config | |
加入频道。
token | 应用服务器从PANO获得的安全令牌。 |
channelId | 客户定义的频道标识。必须符合以下规则:
|
userId | 客户定义的用户标识。必须是唯一的。 在 [0xFFFEFF0000000000, 0xFFFEFFFFFFFFFFFF] 之间的 ID 保留给 SDK 使用 |
config | 频道设置。(可选) |
- (PanoResult) muteAudio |
静音。
- (PanoResult) muteScreen |
暂停屏幕共享。
- (PanoResult) muteVideo |
暂停视频。
- (PanoResult) pauseAudioMixing: | (SInt64) | taskId |
暂停混音任务。
taskId | 任务标识。 |
- (PanoDeviceRating) queryDeviceRating |
查询当前设备的评分值。
- (PanoResult) removeSharedScreenSource: | (PanoScreenSourceID) | id | |
withType: | (PanoScreenSourceType) | type | |
移除屏幕采集源,必须在 beginScreenConfiguration 之后调用。(仅限macOS)
id | 屏幕源唯一标识. |
type | PanoScreenSourceType 枚举类型,不能为显示器类型。 |
- (PanoResult) removeUnsharedScreenSource: | (PanoScreenSourceID) | id | |
withType: | (PanoScreenSourceType) | type | |
移除不被共享的屏幕源,必须在 beginScreenConfiguration 之后调用。(仅限macOS)
id | 屏幕源唯一标识. |
type | PanoScreenSourceType 枚举类型,不能为显示器类型。 |
- (PanoResult) resumeAudioMixing: | (SInt64) | taskId |
恢复被暂停的混音任务。
taskId | 任务标识。 |
- (PanoResult) seekAudioMixing: | (SInt64) | taskId | |
timestamp: | (SInt64) | timestampMs | |
跳转至指定时间戳。
taskId | 任务标识。 |
timestampMs | 时间戳。 |
- (PanoResult) selectSharedScreen: | (PanoScreenSourceID) | id |
选择需要共享的屏幕,必须在 beginScreenConfiguration 之后调用。(仅限macOS)
id | 屏幕源唯一标识. |
- (PanoResult) sendAudioControlMessage: | (NSData *) | data |
发送音频控制消息。
data | 音频控制消息数据。 |
- (PanoResult) sendFeedback: | (PanoFeedbackInfo *_Nonnull) | info |
发送用户反馈到 PANO。
info | 反馈的信息。 |
- (PanoResult) setAudioDeviceVolume: | (UInt32) | volume | |
withType: | (PanoDeviceType) | type | |
设置当前音频设备的音量。
volume | 有效值范围: [0, 255]。 |
type | 设备类型,PanoDeviceType 枚举类型。 |
- (PanoResult) setAudioIndication: | (BOOL) | enable | |
intervalMs: | (UInt32) | intervalMs | |
设置用户指示器。
enable | 提示汇报器开启标志位(默认开启回调)。 |
intervalMs | 回调时间间隔,单位毫秒,不能低于10ms。 |
- (PanoResult) setDefaultDeviceWithType: | (PanoDeviceType) | type |
设置系统默认设备为当前设备。(仅限macOS)
type | 设备类型,PanoDeviceType 枚举类型。 |
- (PanoResult) setDevice: | (NSString *_Nonnull) | deviceId | |
withType: | (PanoDeviceType) | type | |
设置当前设备。(仅限macOS)
deviceId | 设备唯一标识。 |
type | 设备类型,PanoDeviceType 枚举类型。 |
- (PanoResult) setDeviceBoundMediaProcessor: | (PanoMediaProcessorType) | type | |
processor: | (NSObject *_Nullable) | processor | |
param: | (void *_Nullable) | param | |
forDevice: | (NSString *_Nonnull) | deviceId | |
向指定的设备设置媒体处理模块。
type | 媒体处理类型。目前支持的类型: kVideoPreprocessor 。 |
processor | 媒体处理器。值为空表示停止对应的媒体处理。 |
param | 媒体处理需要的参数。 |
deviceId | 设备唯一标识。 |
- (PanoResult) setDeviceBoundOption: | (NSObject *_Nullable) | option | |
forType: | (PanoOptionType) | type | |
forDevice: | (NSString *_Nonnull) | deviceId | |
向指定的设备设置可选项。
option | 选项对象。 |
type | PanoOptionType 枚举类型。 目前支持的类型: kPanoOptionFaceBeautify , kPanoOptionBuiltinTransform , kPanoOptionQuadTransform 。 |
deviceId | 设备唯一标识。 |
+ (void) setLogLevel: | (PanoLogLevel) | level |
设置日志输出级别。
level | PanoLogLevel 枚举类型. |
- (PanoResult) setLoudspeakerStatus: | (BOOL) | enable |
设置扬声器启用状态。(仅限iOS)
enable | 是否启用。 |
- (PanoResult) setMediaProcessor: | (PanoMediaProcessorType) | type | |
processor: | (NSObject *_Nullable) | processor | |
param: | (void *_Nullable) | param | |
设置外部媒体处理模块。
type | 媒体处理类型。 |
processor | 媒体处理器。值为空表示停止对应的媒体处理。 |
param | 媒体处理需要的参数。 |
- (PanoResult) setMicrophoneMuteStatus: | (BOOL) | muted |
设置麦克风采集数据静音状态(不包括伴音等其他声音)
muted | 静音开关, 打开/关闭 静音 |
- (PanoResult) setOption: | (NSObject *_Nullable) | option | |
forType: | (PanoOptionType) | type | |
设置选项对象给PANO SDK。
option | 选项对象。 |
type | PanoOptionType 枚举类型。 |
- (PanoResult) setParameters: | (NSString *_Nonnull) | param |
设置自定义参数给PANO SDK。
param | JSON格式参数。 |
- (PanoResult) setPlayoutDataMuteStatus: | (BOOL) | muted |
设置播放数据静音状态
muted | 静音开关, 打开/关闭 静音开关 |
- (PanoResult) setScreenOptimization: | (BOOL) | motion |
设置屏幕优化启用状态。(仅限macOS)
enable | 是否启用。 |
- (PanoResult) setScreenSource: | (PanoScreenSourceID) | id | |
withType: | (PanoScreenSourceType) | type | |
设置当前屏幕源。(仅限macOS)
id | 屏幕源唯一标识. |
type | PanoScreenSourceType 枚举类型. |
- (PanoResult) snapshotVideo: | (NSString *_Nonnull) | outputDir | |
userId: | (UInt64) | userId | |
option: | (PanoRtcSnapshotVideoOption *_Nullable) | option | |
Capture specific user's video content
outputDir | output directory |
userId | the id of target user |
option | snapshot option |
捕获指定用户的视频画面
outputDir | 输出路径 |
userId | 目标用户的ID |
option | 快照选项 |
- (PanoResult) startAudio |
开启音频。
- (PanoResult) startAudioDeviceTestWithRecord: | (NSString *_Nonnull) | recordDeviceId | |
playout: | (NSString *_Nonnull) | playoutDeviceId | |
开始音频设备测试。(仅限macOS)
recordDeviceId | 录音设备 ID。 |
playoutDeviceId | 播放设备 ID。 |
- (PanoResult) startAudioDumpWithFilePath: | (NSString *_Nonnull) | filePath | |
maxFileSize: | (SInt64) | maxFileSize | |
开启音频转储。
filePath | 转储文件路径,包含文件名和后缀。例如:/path/panoaudio.dump |
maxFileSize | 最大转储文件大小. 如果值为-1,则文件大小不受限制。 |
- (PanoResult) startAudioMixingTask: | (SInt64) | taskId | |
withConfig: | (PanoRtcAudioMixingConfig *_Nonnull) | config | |
启动混音任务。
taskId | 任务标识。 |
config | 配置参数。 |
- (PanoResult) startAudioPlayback |
开始音频设备播放(建议配合外部采集播放时的一些特殊需求使用)
- (PanoResult) startAudioRecording |
开始音频设备录音(建议配合外部采集播放时的一些特殊需求使用)
- (PanoResult) startNetworkTestWithToken: | (NSString *_Nonnull) | token | |
delegate: | (id< PanoRtcNetworkTestDelegate > _Nonnull) | delegate | |
启动网络测试。
token | App服务器向PANO获取的token。注意:不要使用加入频道时使用的 token。 |
delegate | 测试结果回调,在调用 stopNetworkTest 之前必须保持有效。 |
- (PanoResult) startPlayoutDeviceTest: | (NSString *_Nonnull) | playoutDeviceId | |
filename: | (NSString *_Nonnull) | filename | |
开始音频播放设备测试。(仅限macOS)
playoutDeviceId | 播放设备 ID。 |
filename | 音频文件的完整路径。支持mp3,aac,wav。 |
- (PanoResult) startPreview: | (NSString *_Nonnull) | deviceId | |
withDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
profile: | (PanoVideoProfileType) | profile | |
开启摄像头预览(随带外置渲染器)。(仅限macOS)
deviceId | 设备唯一标识。 |
delegate | PanoRtcRenderDelegate 协议对象。 |
profile | PanoVideoProfileType 枚举类型,摄像头预览的设定档。 |
- (PanoResult) startPreview: | (NSString *_Nonnull) | deviceId | |
withView: | (PanoView *_Nonnull) | view | |
config: | (PanoRtcVideoConfig *_Nullable) | config | |
开启摄像头预览(随带渲染视图)。(仅限macOS)
deviceId | 设备唯一标识。 |
view | PanoView 对象。 |
config | PanoRtcVideoConfig 对象。 |
- (PanoResult) startPreviewWithDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
profile: | (PanoVideoProfileType) | profile | |
开启当前摄像头预览(随带外置渲染器)。(仅限iOS)
delegate | PanoRtcRenderDelegate 协议对象。 |
profile | PanoVideoProfileType 枚举类型,摄像头预览的设定档。 |
- (PanoResult) startPreviewWithView: | (PanoView *_Nonnull) | view | |
config: | (PanoRtcVideoConfig *_Nullable) | config | |
开启当前摄像头预览(随带渲染视图)。(仅限iOS)
view | PanoView 对象。 |
config | PanoRtcVideoConfig 对象。 |
- (PanoResult) startRecordDeviceTest: | (NSString *_Nonnull) | recordDeviceId |
开始音频采集设备测试。(仅限macOS)
recordDeviceId | 录音设备 ID。 |
- (PanoResult) startScreen |
开启屏幕共享。
- (PanoResult) startScreenWithAppGroupId: | (ios(11.0)) | API_AVAILABLE |
开启屏幕共享。(该接口支持 iOS 11.0 及以上的 iPhone 和 iPad)
appGroupId | Application Group Identifier。(可选) |
- (PanoResult) startSoundCardMonitor: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate |
开始声卡数据监控器。(仅限macOS)
delegate | PanoRtcRenderDelegate 协议对象。 |
- (PanoResult) startSoundCardShare |
开启声卡音频共享。(仅限macOS)
- (PanoResult) startVideoWithDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
config: | (PanoRtcVideoSourceConfig *_Nullable) | config | |
开启视频(随带外置渲染器)。
delegate | PanoRtcRenderDelegate 协议对象。 |
config | PanoRtcVideoSourceConfig 对象。 |
- (PanoResult) startVideoWithDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
profile: | (PanoVideoProfileType) | profile | |
开启视频(随带外置渲染器)。
delegate | PanoRtcRenderDelegate 协议对象。 |
profile | PanoVideoProfileType 枚举类型,视频发送的设定档。 |
- (PanoResult) startVideoWithView: | (PanoView *_Nullable) | view | |
config: | (PanoRtcVideoConfig *_Nullable) | config | |
开启视频(随带渲染视图)。
view | PanoView 对象。 |
config | PanoRtcVideoConfig 对象。 |
- (PanoResult) stopAudio |
停止音频。
- (PanoResult) stopAudioDeviceTest |
停止音频设备测试。(仅限macOS)
- (PanoResult) stopAudioDump |
停止音频转储。
- (PanoResult) stopAudioMixingTask: | (SInt64) | taskId |
结束混音任务。
taskId | 任务标识。 |
- (PanoResult) stopAudioPlayback |
关闭音频设备播放(建议配合外部采集播放时的一些特殊需求使用)
- (PanoResult) stopAudioRecording |
关闭音频设备录音(建议配合外部采集播放时的一些特殊需求使用)
- (PanoResult) stopNetworkTest |
停止网络测试。
- (PanoResult) stopPlayoutDeviceTest |
停止音频播放设备测试。(仅限macOS)
- (PanoResult) stopPreview |
停止当前摄像头预览。(仅限iOS)
- (PanoResult) stopPreview: | (NSString *_Nonnull) | deviceId |
停止摄像头预览。(仅限macOS)
deviceId | 设备唯一标识。 |
- (PanoResult) stopRecordDeviceTest |
停止音频采集设备测试。(仅限macOS)
- (PanoResult) stopScreen |
停止屏幕共享。
- (PanoResult) stopSoundCardMonitor |
停止声卡数据监控器。(仅限macOS)
- (PanoResult) stopSoundCardShare |
停止声卡音频共享。(仅限macOS)
- (PanoResult) stopVideo |
停止视频。
- (PanoResult) subscribeAudio: | (UInt64) | userId |
订阅用户的音频。
userId | 客户定义的用户标识。 |
- (PanoResult) subscribeScreen: | (UInt64) | userId | |
withDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
订阅用户的屏幕共享(随带外置渲染器)。
userId | 客户定义的用户标识。 |
delegate | PanoRtcRenderDelegate 协议对象。 |
- (PanoResult) subscribeScreen: | (UInt64) | userId | |
withView: | (PanoView *_Nonnull) | view | |
订阅用户的屏幕共享(随带渲染视图)。
userId | 客户定义的用户标识。 |
view | PanoView 对象。 |
- (PanoResult) subscribeVideo: | (UInt64) | userId | |
withDelegate: | (id< PanoRtcRenderDelegate > _Nonnull) | delegate | |
profile: | (PanoVideoProfileType) | profile | |
订阅用户的视频(随带外置渲染器)。
userId | 客户定义的用户标识。 |
delegate | PanoRtcRenderDelegate 协议对象。 |
profile | PanoVideoProfileType 枚举对象,视频订阅的设定档。 |
- (PanoResult) subscribeVideo: | (UInt64) | userId | |
withView: | (PanoView *_Nullable) | view | |
config: | (PanoRtcVideoConfig *_Nullable) | config | |
订阅用户的视频(随带渲染视图)。
userId | 客户定义的用户标识。 |
view | PanoView 对象。 |
config | PanoRtcVideoConfig 对象。 |
- (PanoResult) switchCamera |
切换前后置摄像头。(仅限iOS)
- (PanoResult) switchWhiteboardEngine: | (NSString *_Nonnull) | whiteboardId |
切换白板控制对象
whiteboardId | 白板Id。最大长度128字节,UTF8String。 |
- (PanoResult) unmuteAudio |
取消静音。
- (PanoResult) unmuteScreen |
恢复屏幕共享。
- (PanoResult) unmuteVideo |
恢复视频。
- (PanoResult) unsubscribeAudio: | (UInt64) | userId |
取消订阅用户的音频。
userId | 客户定义的用户标识。 |
- (PanoResult) unsubscribeScreen: | (UInt64) | userId |
取消订阅用户的屏幕共享。
userId | 客户定义的用户标识。 |
- (PanoResult) unsubscribeVideo: | (UInt64) | userId |
取消订阅用户的视频。
userId | 客户定义的用户标识。 |
- (PanoResult) updateAudioMixingTask: | (SInt64) | taskId | |
withConfig: | (PanoRtcAudioMixingConfig *_Nonnull) | config | |
更新混音任务配置参数。
taskId | 任务标识。 |
config | 配置参数。 |
- (PanoResult) updateConfig: | (PanoRtcEngineConfig *_Nonnull) | config |
更新 PanoRtcEngineKit 对象配置。
config | PanoRtcEngineConfig 对象. |
- (PanoResult) updateScreenMoving: | (UInt64) | userId | |
withDistance: | (CGPoint) | distance | |
更新屏幕的相对移动距离。
userId | 客户定义的用户标识。 |
distance | 屏幕焦点移动距离。 |
- (PanoResult) updateScreenScaling: | (UInt64) | userId | |
withRatio: | (PanoScreenScalingRatio) | ratio | |
更新屏幕的绝对缩放比例。
userId | 客户定义的用户标识。 |
ratio | 屏幕缩放比例类型。 |
- (PanoResult) updateScreenScaling: | (UInt64) | userId | |
withRatio: | (CGFloat) | ratio | |
focus: | (CGPoint) | focus | |
更新屏幕的相对缩放比例。
userId | 客户定义的用户标识。 |
ratio | 屏幕缩放比例值。 |
focus | 屏幕焦点坐标值。 |
- (PanoRtcWhiteboard *_Nonnull) whiteboardEngine |
获取白板控制对象。
|
readnonatomicassign |
获取标注管理器对象。
|
readnonatomicassign |
获取分组管理器的接口指针
|
readnonatomicassign |
获取消息服务的接口指针
|
readnonatomicassign |
获取录制服务接口
|
readnonatomicassign |
获取远程控制服务的接口指针
|
readnonatomicassign |
获取视频渲染管理器
|
readnonatomicassign |