基于@ohos.pasteboard实现剪贴板功能

基于@ohos.pasteboard实现剪贴板功能

HarmonyOS
2024-07-24 10:27:02
1.2w浏览
已于2024-7-25 11:43:41修改
收藏 0
回答 1
回答 1
按赞同
/
按时间
躺平嗑产品懒猫

本模块主要提供管理系统剪贴板的能力,为系统复制、粘贴功能提供支持。系统剪贴板支持对文本、HTML、URI、Want、PixelMap等内容的操作。

场景一:手动点击按钮进行复制粘贴

使用场景:安全控件会在点击粘贴按钮时给业务临时授予ohos.permission.SECURE_PASTE权限,因此使用安全控件访问剪贴板的业务不会受此次非兼容性变更的影响,暂未使用安全控件的业务也可以通过使用安全控件访问剪贴板内容。

效果图

实现方案

1. 创建一个粘贴按钮组件*(PasteButton),并设置点击事件处理函数。

2. 调用pasteboard.getSystemPasteboard().getData方法,获取系统剪贴板中的数据。

3. 调用systemPasteboard.setData方法,将指定的文本内容设置到系统剪贴板中。

核心代码

import { pasteboard, BusinessError } from '@kit.BasicServicesKit'; 
 
@Entry 
@Component 
struct Index { 
  @State message: string = ''; 
 
  build() { 
    Row() { 
      Column({ space: 10 }) { 
        TextInput({ placeholder: '请输入验证码', text: this.message }) 
          .onChange((value: string) => { 
            this.message = value; 
          }) 
        PasteButton().onClick((event: ClickEvent, result: PasteButtonOnClickResult) => { 
          if (PasteButtonOnClickResult.SUCCESS === result) { 
            pasteboard.getSystemPasteboard().getData((err: BusinessError, pasteData: pasteboard.PasteData) => { 
              if (err) { 
                console.error(`Failed to get paste data. Code is ${err.code}, message is ${err.message}`); 
                return; 
              } 
              this.message = pasteData.getPrimaryText(); 
            }); 
          } 
        }) 
        Text("复制") 
          .onClick(() => { 
            //剪贴板数据对应的MIME类型,可以是常量中已定义的类型,也可以是自定义的MIME类型,开发者可自定义此参数值, 
            let pasteData: pasteboard.PasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_PLAIN, this.message); 
            let systemPasteboard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard(); 
            systemPasteboard.setData(pasteData, (err, data) => { 
              if (err) { 
                console.error('Failed to set PasteData. Cause: ' + err.message); 
                return; 
              } 
              console.info('Succeeded in setting PasteData.'); 
            }); 
 
          }) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.

// 在module.json5中声明ohos.permission.READ_PASTEBOARD权限 
"requestPermissions": [ 
  { 
    "name": "ohos.permission.READ_PASTEBOARD", 
    "reason": "$string:app_name", 
    "usedScene": { 
      "abilities": [ 
        "EntryAbility", 
      ], 
      "when": "always" 
    } 
  } 
]
// 检查当前应用程序是否已经被授予权限 
async function checkAccessToken(permission: Permissions): Promise<abilityAccessCtrl.GrantStatus> { 
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager(); 
  //初始化grantStatus 变量,表示权限被拒绝的初始状态 
  let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED; 
 
  // 获取应用程序的accessTokenID 
  let tokenId: number = 0; 
  try { 
    //获取应用程序信息 
    let bundleInfo: bundleManager.BundleInfo = 
      await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION); 
    let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo; 
    tokenId = appInfo.accessTokenId; 
  } catch (error) { 
    let err: BusinessError = error as BusinessError; 
    console.error(`Failed to get bundle info for self. Code is ${err.code}, message is ${err.message}`); 
  } 
 
  // 校验应用是否被授予权限 
  try { 
    grantStatus = await atManager.checkAccessToken(tokenId, permission); 
  } catch (error) { 
    let err: BusinessError = error as BusinessError; 
    console.error(`Failed to check access token. Code is ${err.code}, message is ${err.message}`); 
  } 
  return grantStatus; 
}
// 向用户申请授权 
reqPermissionsFromUser(permissions: Array<Permissions> = ['ohos.permission.READ_PASTEBOARD']): void { 
  let context = getContext(this) as common.UIAbilityContext; 
  let atManager = abilityAccessCtrl.createAtManager(); 
  // requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗 
  atManager.requestPermissionsFromUser(context, permissions).then((data) => { 
    let grantStatus: Array<number> = data.authResults; 
    let length: number = grantStatus.length; 
    for (let i = 0; i < length; i++) { 
      if (grantStatus[i] === 0) { 
        // 用户授权,可以继续访问目标操作 
        this.permission_state = true; 
      } else { 
        // 用户拒绝授权,提示用户必须授权才能访问当前页面的功能 
        console.error("user did not grant!") 
        this.permission_state = false; 
      } 
    } 
  }) 
}
//获取系统剪贴板的内容 
async getPaste(): Promise < string > { 
  const permissions: Array<Permissions> =['ohos.permission.READ_PASTEBOARD']; 
  // 调用前面定义的 checkAccessToken 函数来检查是否已授予读取剪贴板的权限 
  let grantStatus: abilityAccessCtrl.GrantStatus = await checkAccessToken(permissions[0]); 
  //检查 grantStatus 是否为 PERMISSION_GRANTED,即检查是否已授予权限 
  if(grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) { 
    try { 
      //获取系统剪贴板对象 
      let systemPasteboard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard(); 
      let pasteData = await systemPasteboard.getData(); 
      return pasteData.getPrimaryText(); 
    } catch (err) { 
      hilog.error(0x0000, 'testTag', '%{public}s', `get oaid by promise catch error: ${err.code} ${err.message}`); 
      return ''; 
    } 
  } else { 
    // 申请权限 
    if (this.permission_state) { 
      this.reqPermissionsFromUser(permissions); 
    } 
    return ''; 
  } 
}
//页面跳转 
function onJumpClick(pageJump: string): void { 
  router.pushUrl({ 
    url: pageJump // 目标url 
  }, router.RouterMode.Standard, (err) => { 
    if (err) { 
      console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`); 
      return; 
    } 
    console.info('Invoke pushUrl succeeded.'); 
  }); 
}
//口令识别 
let text = await this.getPaste(); 
if (text.includes('口令')) { 
  onJumpClick('pages/Second'); 
} else { 
  onJumpClick('pages/Third'); 
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.
  • 59.
  • 60.
  • 61.
  • 62.
  • 63.
  • 64.
  • 65.
  • 66.
  • 67.
  • 68.
  • 69.
  • 70.
  • 71.
  • 72.
  • 73.
  • 74.
  • 75.
  • 76.
  • 77.
  • 78.
  • 79.
  • 80.
  • 81.
  • 82.
  • 83.
  • 84.
  • 85.
  • 86.
  • 87.
  • 88.
  • 89.
  • 90.
  • 91.
  • 92.
  • 93.
  • 94.
  • 95.
  • 96.
  • 97.
  • 98.
  • 99.
  • 100.
  • 101.
  • 102.
  • 103.
  • 104.
分享
微博
QQ
微信
回复
2024-07-25 11:12:11


相关问题
读取剪贴板是否需要READ_PASTEBOARD权限
2483浏览 • 1回复 待解决
HarmonyOS 剪贴板
521浏览 • 1回复 待解决
HarmonyOS 剪贴板问题
668浏览 • 1回复 待解决
HarmonyOS 剪贴板用法
544浏览 • 1回复 待解决
关于读取剪贴板内容咨询
521浏览 • 1回复 待解决
系统剪贴板可以存储哪些数据?
848浏览 • 1回复 待解决
无法读取系统剪贴板内容
714浏览 • 1回复 待解决
HarmonyOS 跨设备剪贴板开发咨询
597浏览 • 1回复 待解决
HarmonyOS 应用获取剪贴板内容问题
346浏览 • 1回复 待解决
HarmonyOS 系统剪贴板的复制粘贴方法
750浏览 • 1回复 待解决
如何将内容直接复制到剪贴板
1202浏览 • 1回复 待解决
如何将纯文本数据写入系统剪贴板
848浏览 • 1回复 待解决