# USBåç³»ç»Ÿå˜æ›´è¯´æ˜Ž ## cl.USB .1 USB管ç†åŠŸèƒ½æ¨¡å—æŽ¥å£åºŸå¼ƒ **访问级别** ç³»ç»ŸæŽ¥å£ **åºŸå¼ƒåŽŸå› ** USBæ¨¡å—æŽ¥å£å¢žåŠ æƒé™æŽ§åˆ¶ï¼Œæ–°å¼€æ”¾çš„æŽ¥å£åŒ…嫿—§çš„系统级接å£å®Œæ•´åŠŸèƒ½ï¼ŒæŽ¥å£æ›´åŠ æ ‡å‡†å¹¶ä¸”åŽŸå化,符åˆç¤¾åŒºAPI规范。 **废弃影å“** éžå…¼å®¹æ€§å˜æ›´ï¼Œéœ€è¦å¼€å‘者进行适é…。 **废弃å‘生版本** 从OpenHarmony SDK 4.1.5.1开始。 **废弃的接å£** 修改ä¸åˆç†çš„é‰´æƒæ–¹å¼æ•´æ”¹ã€‚ä¸å…许使用调用方进程APLç‰çº§è¿›è¡Œæƒé™æ ¡éªŒï¼Œéœ€è¦ä¿®æ”¹ä¸ºä½¿ç”¨AccessTokenKit::VerifyAccessToken对访问者进行æƒé™æ ¡éªŒï¼Œæ–°æŽ¥å£è°ƒç”¨è€…需è¦ç”³è¯·ohos.permission. MANAGE_USB_CONFIGæƒé™ã€‚ | 接å£å£°æ˜Ž | 废弃说明 | æ›¿ä»£æŽ¥å£ | | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | | function addRight(bundleName: string, deviceName: string): boolean; | 使用usb.addDeviceAccessRightæŽ¥å£æ·»åŠ è½¯ä»¶åŒ…è®¿é—®è®¾å¤‡çš„æƒé™ã€‚ | function addDeviceAccessRight(bundleName: string, deviceName: string): boolean; | | function usbFunctionsFromString(funcs: string): number; | 使用usb.getFunctionsFromString接å£å°†å—符串形å¼çš„USBåŠŸèƒ½åˆ—è¡¨è½¬åŒ–ä¸ºæ•°å—æŽ©ç | function getFunctionsFromString(funcs: string): number; | | function usbFunctionsToString(funcs: FunctionType): string; | 使用usb.convertFunctionsToString接å£å°†æ•°å—掩ç å½¢å¼çš„USB功能列表转化为å—符串。 | function convertFunctionsToString(funcs: FunctionType): string; | | function setCurrentFunctions(funcs: FunctionType): Promise<void>; | 使用usb.setDeviceFunctions接å£è®¾ç½®å½“å‰çš„USB功能列表。 | function setDeviceFunctions(funcs: FunctionType): Promise<void>; | | function getCurrentFunctions(): FunctionType; | 使用usb.getDeviceFunctions接å£èŽ·å–当å‰çš„USB功能列表的数å—ç»„åˆæŽ©ç 。 | function getDeviceFunctions(): FunctionType; | | function getPorts(): Array<USBPort>; | 使用usb.getUsbPorts接å£èŽ·å–æ‰€æœ‰ç‰©ç†USBç«¯å£æè¿°ä¿¡æ¯ã€‚ | function getUsbPorts(): Array<USBPort>; | | function getSupportedModes(portId: number): PortModeType; | 使用usb.getUsbPortSupportModes接å£èŽ·å–æŒ‡å®šçš„ç«¯å£æ”¯æŒçš„æ¨¡å¼åˆ—è¡¨çš„ç»„åˆæŽ©ç | function getUsbPortSupportModes(portId: number): PortModeType; | | function setPortRoles(portId: number, powerRole: PowerRoleType, dataRole: DataRoleType): Promise<void>; | 使用usb.setUsbPortRoles接å£è®¾ç½®æŒ‡å®šçš„ç«¯å£æ”¯æŒçš„角色模å¼ï¼ŒåŒ…å«å……ç”µè§’è‰²ã€æ•°æ®ä¼ 输角色。 | function setUsbPortRoles(portId: number, powerRole: PowerRoleType, dataRole: DataRoleType): Promise<void>; | **适酿Œ‡å¯¼** å˜æ›´å‰ 应用é…置文件xxx.cfgä¸çš„aplå—æ®µæ˜¯system_basic 或者 system_core。 å˜æ›´åŽ é…置文件ä¸çš„permission å—æ®µéœ€è¦æ·»åŠ ohos.permission.MANAGE_USB_CONFIGæƒé™ã€‚